The OPERA GeoAgent¶

The plugin embeds the maplibre-gl-geoagent MapLibre control and registers OPERA tools on top of it, similar to how the QGIS NASA OPERA plugin launches the OpenGeoAgent panel. The GeoAgent sits on its own map button, so the search workflow and the chat assistant stay open independently.

Providers: OpenAI Responses, OpenAI Chat, Anthropic, Google Gemini, Amazon Bedrock, and any OpenAI-compatible endpoint. Provider settings and keys are handled in the GeoAgent panel.

Registered tools¶

Tool	What it does
`get_opera_context`	List supported products, current settings, and the latest search results.
`search_opera_granules`	Search NASA CMR and populate the results table plus footprint layer.
`display_opera_granules`	Render selected search results as titiler-cmr raster layers.
`search_and_display_opera`	Search and immediately display the first matching granules.
`detect_opera_change_between_dates`	Find nearest before/after granules, display both, and compute AOI change statistics.
`analyze_opera_time_series`	Track AOI statistics across granules over a date range and report first-to-last trend metrics.
`export_opera_change_report`	Return a Markdown or JSON report for the latest change detection result.
`titiler_cmr_tilejson`	Build TileJSON from arbitrary `rasterio` or `xarray` backend parameters.
`titiler_cmr_point_query`	Sample raster pixels or xarray variables at a lon/lat point.
`titiler_cmr_statistics`	Backend-aware AOI statistics from a bbox or GeoJSON geometry.
`titiler_cmr_timeseries_tilejson`	Time-indexed TileJSON for temporal workflows.
`map_disaster_event`	Run the standard disaster workflow from a hazard, a place or AOI, and event dates.
`map_disaster_context`	Overture buildings and transportation plus WorldPop population for any AOI.
`sentinel2_event_imagery`	Least-cloudy Sentinel-2 L2A true-color scene for the event window.
`derive_flood_benchmark`	Vectorize observed DSWx water into a locked flood extent.
`get_benchmark`	Return the locked flood benchmark, or prompt for one when none is locked.
`overture_in_flood`	Count flooded buildings and clip transportation centerlines to the extent.
`buildings_in_flood`	OSM Overpass fallback for building exposure when Overture queries are unavailable.
`population_in_flood`	WorldPop modeled residential population inside the flood extent.
`news_impact_search`	Quantified impact figures with source URLs and dates.
`search_disasters`	Find historical, current, or explicitly dated disasters with citable sources.
`build_one_pager`	Assemble the print-ready HTML summary.

Prompts that drive it¶

Search and display one OPERA DSWx-HLS surface water granule for bbox
-121.8,38.4,-121.2,38.8 from 2024-02-01 to 2024-02-29. Use band B01_WTR.

Show RTC-S1 VV backscatter near Sacramento for February 2024 and display the
first two scenes in gray.

Detect DSWx-HLS surface water change for bbox -121.8,38.4,-121.2,38.8 between
2024-02-01 and 2024-03-01. Use band B01_WTR and a 10 day search window.

Use titiler_cmr_statistics with the rasterio backend to compute a categorical
histogram for the displayed DSWx B01_WTR layer over the current AOI.

Map the flood in Valencia Region, Spain from 2024-10-27 to 2024-11-05.

Hazard-specific source policy¶

When the user does not name sources, map_disaster_event applies a deterministic policy per hazard.

FLOODS: Grouped pre- and post-event OPERA and Sentinel-2 layers, all Overture buildings and typed transportation in the AOI, highlighted flooded buildings and affected roads, and open-access WorldPop exposure.
WILDFIRES: The matching NASA Disasters event group from NASA Earthdata GIS first, then FEDS perimeters, NASA burn-severity products, and OPERA DIST. When a time-filtered FEDS perimeter exists, the latest perimeter per fire becomes the exposure boundary and Overture and WorldPop queries narrow to it.

If a perimeter or exposure service is unavailable, the workflow reports that limitation rather than labeling general context as impact.

Credentials¶

This is a browser-side agent

Provider SDKs run in the page and talk to the model provider directly. Keys are stored in sessionStorage under the geolibre.nasa-opera.geoagent prefix after the user commits them. Use it in trusted local or internal deployments, or put a backend proxy in front of provider credentials for anything public.

This plugin embeds GeoAgent with both JavaScript execution and destructive layer-removal tools enabled by default, and it hides the permission toggles (allowCodeExecutionDefault, allowDestructiveToolsDefault, and showPermissionToggles: false in src/geolibre.ts). The agent can therefore remove layers and run JavaScript against the live map without a further prompt, which is another reason to keep it to trusted deployments.

The OpenAI key can optionally be baked into the build from OPENAI_API_KEY so demo users never see a key prompt. That ships the key to every browser that loads the app, so keep it to controlled deployments. See Install.