Discovery

The catalog is a web service that returns metadata of Earth Observation products in various formats when queried.

This section is about discovery, i.e. the question what the catalog actually offers. The ways how to use the catalog for queries are covered in the next the next section.

Terradue’s catalog is at the URL https://catalog.terradue.com

The catalog is divided into compartments of metadata, called indices. These are used to separate information based on the purposes for which it is used, and for access control. You have access to your own personal index and to a number of others, based on your affiliation and roles in projects.

Exploring indices in the catalog

Let’s have a simple look at the indices available. With the following cURL command, you see a list of the indices you can access:

Simple JSON

curl -u mrossi:ABcdEF "https://catalog.terradue.com"

The response is a JSON document with an array containing information about the indidces.

  {
    "indices": [
        {
            "authors": [
                {
                    "name": "Mario Rossi",
                    "mail": "mrossi@test.com"
                }
            ],
            "created": "2016-06-03T10:30:42.7708920Z",
            "description": "Index containing the entries of the datasets published and saved by Mario Rossi.",
            "indexName": "mrossi",
            "lastMigrated": "2016-06-03T10:30:42.6951710Z",
            "version": 2
        },
        {
            "authors": [
                {
                    "name": "Terradue DevOps team",
                    "uri": "https://www.terradue.com"
                }
            ],
            "created": "2016-06-03T10:30:42.7708920Z",
            "description": "Index containing the entries of the datasets of Landsat-8 American Earth observation satellite launched on February 11, 2013. It is the eighth satellite in the Landsat program.",
            "indexName": "landsat8",
            "lastMigrated": "2016-06-03T10:30:42.6951710Z",
            "version": 2
        },
        {
            "authors": [
                {
                    "name": "Terradue DevOps team",
                    "uri": "https://www.terradue.com"
                }
            ],
            "created": "2016-06-03T10:30:42.7708920Z",
            "description": "Index containing the entries of the datasets of Envisat. Envisat was launched as an Earth observation satellite. Its objective was to service the continuity of European Remote-Sensing (ERS) Satellite missions, providing additional observational parameters to improve environmental studies.",
            "indexName": "envisat",
            "lastMigrated": "2016-06-03T10:30:42.6951710Z",
            "version": 2
        },
        {
            "authors": [
                {
                    "name": "Terradue DevOps team",
                    "uri": "https://www.terradue.com"
                }
            ],
            "created": "2016-06-03T10:30:42.7708920Z",
            "description": "Index containing the entries of the datasets of Sentinel-1 space mission funded by the European Union and carried out by the ESA within the Copernicus Programme.",
            "indexName": "sentinel1",
            "lastMigrated": "2016-06-03T10:30:42.6951710Z",
            "version": 2
        },
        {
            "authors": [
                {
                    "name": "Terradue DevOps team",
                    "uri": "https://www.terradue.com"
                }
            ],
            "created": "2016-06-03T10:30:42.7708920Z",
            "description": "Index containing the entries of the datasets of Sentinel-2. Sentinel-2 is an Earth observation mission developed by ESA as part of the Copernicus Programme to perform terrestrial observations in support of services such as forest monitoring, land cover changes detection, and natural disaster management.",
            "indexName": "sentinel2",
            "lastMigrated": "2016-06-03T10:30:42.6951710Z",
            "version": 2
        }
    ]
}

OpenSearch

Alternatively, the indices can be queried using opensearch-client with base syndication model and filtered.

opensearch-client -u mrossi:ABcdEF "https://catalog.terradue.com/search" identifier

And the response is the following list of identifiers:

sentinel1
landsat8
mrossi

Exploring series in the indices

Indices can define subset of the entries they contain called Series. The series can be discovered this way using cURL.

curl "https://catalog.terradue.com/mrossi/series/search"

This command will return an atom feed with all the series in the indices mrossi.

The same command with opensearch-client and a few more parameter allows to find the link to search then in the series themselves:

opensearch-client "https://catalog.terradue.com/mrossi/series/search" title,describes

Exploring data packages in the portal

You also can discover all the data packages available from the portal.

curl "<portal_api_url>/data/package/search?q=etna"

This command will return an atom feed with all the data packages where there is mentionned “etna” in the title, keywords, tags or content.

The same command with opensearch-client and a few more parameter allows to find the link to search then in the data packages themselves:

opensearch-client "<portal_api_url>/data/package/search?q=etna" title,describes

This returns for instance

Etna November 2014,<portal_api_url>/data/package/etnanov2014/search

Then you can search in the found data package using the returned URL.