TerraCatalogue: STAC API
The SpatioTemporal Asset Catalog (STAC) is an open standard designed to simplify satellite imagery searches by providing consistent metadata for geospatial assets.
The STAC specification has four main parts:
- STAC Item: Represents a single geospatial asset as a GeoJSON feature with a date, time, and links.
- STAC Catalog: A simple JSON file with links to organize and browse STAC Items. Best practices guide its creation.
- STAC Collection: Extends the STAC Catalog with details like extents, licenses, and keywords for STAC Items in the Collection.
- STAC API: A RESTful endpoint for searching STAC Items.
Terrascope offers a STAC API implementing the STAC API v1.0 specification. It is based on the stac-fastapi project.
The source code for the project is available on GitHub: https://github.com/VITObelgium/terra-stac-api.
The API documentation is available online as an interactive Swagger UI.
Example requests
Table 1 provides examples to help users get started with the TerraCatalogue STAC interface.
| General | TerraCatalogue STAC endpoint |
|---|---|
| STAC API URL | https://stac.terrascope.be/ |
| STAC Collections | List collections |
| Discover all collections | /collections |
| Discover all details of one collection e.g. Terrascope Sentinel-2 FAPAR | /collections/terrascope-s2-fapar-v2 |
| STAC Items | List items |
| Discover all Sentinel-2 FAPAR V2 Items | /collections/terrascope-s2-fapar-v2/items |
| Directly retrieve a single Item using collection and product identifier | /collections/terrascope-s2-fapar-v2/items/S2B_20240227T105919_31UES_FAPAR_10M_V210 |
| STAC Item Search | Item search with basic parameters: collections, ids, bbox, datetime,limit |
| Discover all items of one collection e.g. Terrascope Sentinel 2 FAPAR via search | /search?collections=terrascope-s2-fapar-v2 |
| Discover all Sentinel-2 LAI V2 Items, between 05/01/2020 and 15/01/2020 | /search?collections=terrascope-s2-lai-v2&datetime=2020-01-05T00:00:00Z/2020-01-15T23:59:59Z |
| Discover all Sentinel-2 LAI V2 Items, between 05/01/2020 and 15/01/2020 for the northern hemisphere with bounding box -180, 0, 180, 90 | /search?collections=terrascope-s2-lai-v2&datetime=2020-01-05T00:00:00Z/2020-01-15T23:59:59Z&bbox=-180.00,0.00,180.00,90.00 |
| Discover the 50 first Sentinel-2 NDVI products V2 | /search?collections=terrascope-s2-ndvi-v2&limit=50 |
| STAC API Filter extension | Advanced item search |
| Search for Sentinel-2 FAPAR V2 Items with 10m resolution | /search?collections=terrascope-s2-fapar-v2&filter="properties.gsd"=10 |
For a more detailed guide on best practices and how to use the STAC API, please refer to the STAC API documentation.
Product Download
Downloading the products on the Terrascope platform is not necessary. The data is available locally on the user’s VM and Notebooks.
The product download documentation contains more information on how to download data when not working on the Terrascope platform.