As a data user, I want to export query results as GeoJSON

[jordanpadams]

Checked for duplicates

Yes - I've already checked

🧑‍🔬 User Persona(s)

Data User, GIS Analyst, Web Developer, Data Visualization Engineer

💪 Motivation

...so that I can visualize product footprints and metadata on web maps using tools like Leaflet, Mapbox, QGIS, and other GIS platforms.

📖 Additional Details

Current Behavior:

• ✅ as_dataframe() exports to pandas DataFrame
• ❌ No GeoJSON export capability
• ❌ Users must manually extract spatial fields and construct GeoJSON

Proposed Solution:
Export results as valid GeoJSON with spatial geometries:

# Export with spatial field configuration
geojson = products.has_target("Mars").observationals().as_geojson(
    lat_field="orex:Spatial.orex:latitude",
    lon_field="orex:Spatial.orex:longitude",
    output_file="mars_data.geojson"
)

# Support different geometry types
products.as_geojson(
    geometry_type="bbox",
    lat_min_field="geom:bbox.lat_min",
    lat_max_field="geom:bbox.lat_max",
    lon_min_field="geom:bbox.lon_min",
    lon_max_field="geom:bbox.lon_max"
)

# Select specific properties to include
products.as_geojson(
    lat_field="orex:Spatial.orex:latitude",
    lon_field="orex:Spatial.orex:longitude",
    properties=["pds:Identification_Area.pds:title", "lidvid"]
)

GeoJSON Output Structure:

{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "geometry": {
      "type": "Point",
      "coordinates": [-122.5, 37.8]
    },
    "properties": {
      "lidvid": "urn:nasa:pds:...:1.0",
      "title": "Mars Image",
      "start_date_time": "2020-01-01T00:00:00Z"
    },
    "id": "urn:nasa:pds:...:1.0"
  }]
}

Implementation Approach:

1. Add as_geojson() method to QueryBuilder
2. Support Point, BBox/Polygon geometry types
3. Configurable property selection
4. Handle missing/invalid spatial data gracefully
5. Use standard library json (no new dependencies)

Related:

• Part of Priority Requirements PDF (Requirement 5)
• Complements geospatial search (As a data user, I want to perform geospatial searches with configurable spatial fields #151)
• Replaces closed issue As a user, I want to export query results as GeoJSON #147

---

For Internal Dev Team To Complete

Acceptance Criteria

Given a user wants to visualize PDS products on a web map
When I perform products.as_geojson(lat_field="...", lon_field="...")
Then I expect a valid GeoJSON FeatureCollection with product metadata and geometries

⚙️ Engineering Details

To be filled by Engineering Node Team

🎉 I&T

To be filled by Engineering Node Team