search_scenes
Search for satellite scenes over a specified area and date range, filtering by sensor or product, and see availability status (ready, archived, on-order, priced) to decide next steps.
Instructions
Search Bhoonidhi scenes for a satellite over an area and date range.
The satellite may be a casual name ("Sentinel-2", "cartosat"); it is matched to the portal's exact tokens, and a constellation expands to all its platforms. Dates are ISO (YYYY-MM-DD). Give the area either as a bounding box (minx/maxx/miny/maxy) or a point with radius (lat/lon/radius_km) — typically from resolve_location. sensor narrows to one sensor on the matched satellite(s) (e.g. "SSAR", "LISS3"); product further narrows to one product under that sensor (e.g. "GCOV", "L2C-Chlorophyll") — see list_archive for the exact sensor/product names each satellite carries. The search is stateless and needs no login.
If the satellite name is ambiguous, returns status="ambiguous_satellite" with candidate names instead of guessing.
Each scene carries an "availability": Ready (downloadable now), Archived (open data but may need a portal request first), OnOrder (must be requested), or Priced (must be purchased). The result includes a plain-English "summary" of these counts and a "how_to_act" block. Tell the user clearly when scenes are Archived, OnOrder, or Priced and what each needs. This search is stateless: to act on these scenes, call save_query with the same arguments to persist them and get a , then download_query (open data) or cart_add (on-order / priced) on that slug — both need a login (see auth_status). Downloads cannot be resumed if interrupted (the portal has no range support).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lon | No | ||
| maxx | No | ||
| maxy | No | ||
| minx | No | ||
| miny | No | ||
| sensor | No | ||
| product | No | ||
| end_date | Yes | ||
| radius_km | No | ||
| satellite | Yes | ||
| start_date | Yes |