Try it in a notebook
Search two catalogs, map scene footprints, and download the results in Colab or Jupyter.
This notebook searches Earth Search and Microsoft Planetary Computer for Sentinel-2 imagery, then maps the results. Use a standard Python CPU runtime; the public metadata searches need no GPU or API key.
Open the notebook
Download the Python quickstart notebook, then open Google Colab and choose File → Upload notebook. You can also open the downloaded file in Jupyter.
Open directly in Colab · View on GitHub
What you will do
- Install SuperSTAC, Pandas, and Folium in the notebook kernel.
- Connect to two catalogs and check which ones offer Sentinel-2.
- Search an area and date range through one Python client.
- Inspect item details, duplicate counts, and catalog failures.
- Display scene footprints and the search area on a map.
- Export full STAC items, metadata, query settings, and a map to a downloadable ZIP.
Run the cells from top to bottom. The sample searches a fixed month around Luxembourg with at most five items per catalog. Change the bounding box, dates, or catalogs to explore another query. If you raise the item limit, update both the query limit and the configured per-catalog cap.
Understand the output
The map shows scene footprints, not satellite pixels. Item asset links may require provider-specific signing or authentication before downloads. The notebook closes the client after searching. The results stay in memory so you can keep exploring them.
Results depend on public catalog availability and the installed alpha version. An empty result is not necessarily a successful search: inspect the discovery table, catalogs_queried, and failures. Python returns each item as a dictionary. Search metadata describes the overall search, but does not say which catalog supplied each item.
Internet access is required for installation, catalog requests, and map tiles. Colab runtime files are temporary, so download the exported ZIP before ending the session. If installation fails because no compatible wheel is available, follow the source installation guide.
Continue with the Python API reference, search parameters, or results and provenance.
