search_eo_scenes
Find satellite scenes in a bounding box on Earth Search, filtering by time, cloud cover, and collection to check data availability and return scene details.
Instructions
Searches satellite SCENES inside a bounding box on Earth Search.
Executes a real STAC item search (pystac-client) against
https://earth-search.aws.element84.com/v1 filtered by spatial extent,
time range and cloud cover. Scenes are the individual acquisitions
(tiles/granules) that become records of a GeoCroissant dataset.
Usage: Use after `search_eo_datasets` (or directly with known
collections) to check actual data availability for an area of interest.
Feed promising results into `create_geocroissant_from_stac`.
Returns:
--------
Dictionary containing:
- scene_count and scenes: Per-scene id, collection, acquisition
datetime, platform, cloud cover, native EPSG and asset keys.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | Yes | Bounding box as [min_lon, min_lat, max_lon, max_lat]. | |
| limit | No | Max scenes returned (1-50). | |
| modality | No | Modality used to pick default collections. | |
| collections | No | Explicit STAC collection ids. Defaults to curated collections for the chosen modality. | |
| datetime_range | No | STAC datetime interval, e.g. "2023-06-01/2023-09-30". | |
| max_cloud_cover | No | Maximum eo:cloud_cover percentage for optical scenes (ignored when None). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||