TerraCatalogue: STAC API
Terrascope supports an experimental STAC API based on the STAC API v1.0.0-rc.1. As this version is still under development, it may change.
The SpatioTemporal Asset Catalog (STAC) is an open standard designed to simplify satellite imagery searches by providing consistent metadata for geospatial assets.
STAC 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.
The current implementation uses the Terrascope OpenSearch API endpoints as its data source. However, the STAC API has fewer search and filter options compared to the OpenSearch API:
- No filtering for collections.
- No support for ATOM response format.
- Fewer product filtering parameters (e.g., lacks resolution, tileId, and cloudCover filters).
A new Catalogue API is under development, fully compliant with the latest STAC and independent of the OpenSearch EO implementation. Although no release date is set, it is expected to be available soon.
The source code for the project is available on GitHub: https://github.com/VITObelgium/opensearch-stac-adapter.
The API documentation is available online.
STAC API in practice (Current Implementation)
Table 1 provides examples to help users get started with the TerraCatalogue STAC interface.
| General | TerraCatalogue STAC endpoint |
|---|---|
| STAC URL | https://services.terrascope.be/stac/ |
| STAC Collections | Collections Search |
| Discover all collections | https://services.terrascope.be/stac/collections |
| Discover all details of one collection e.g. Terrascope SENTINEL-2 FAPAR | ...stac/collections/urn:eop:VITO:TERRASCOPE_S2_FAPAR_V2 |
| STAC Items | Products or items Search |
| Discover all SENTINEL-2 FAPAR Products V2 | ...stac/collections/urn:eop:VITO:TERRASCOPE_S2_FAPAR_V2/items |
| Direct product search using collection and product identifier | ...stac/collections/urn:eop:VITO:TERRASCOPE_S2_FAPAR_V2/items/urn:eop:VITO:TERRASCOPE_S2_FAPAR_V2:S2A_20150704T101006_32TPP_FAPAR_10M_V200 |
| STAC Search | STAC Search with possible parameters: collections /ids/bbox/datetime/limit/token |
| Discover all details of one collection e.g. Terrascope Sentinel 2 FAPAR via search | ...stac/search?collections=urn:eop:VITO:TERRASCOPE_S2_FAPAR_V2 |
| Discover all Sentinel 2 LAI products V2, between 05/01/2020 and 15/01/2020 | ...stac/search?collections=urn:eop:VITO:TERRASCOPE_S2_LAI_V2&datetime=2020-01-05T05:00:00Z/2020-01-15T23:59:59Z |
| Discover all Sentinel 2 LAI products V2, between 05/01/2020 and 15/01/2020 for the northern hemisphere with bounding box -180, 0,180, 90 | ...stac/search?collections=urn:eop:VITO:TERRASCOPE_S2_LAI_V2&datetime=2020-01-05T05:00:00Z/2020-01-15T23:59:59Z&bbox=-180.00,0.00,180.00,90.00 |
| Discover the 10 first Sentinel 2 LAI products V2 | ...stac/search?collections=urn:eop:VITO:TERRASCOPE_S2_LAI_V2&limit=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 from 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.