v1

latestOpenAPI 3.0.3Apache License 2.02026-07-17166173.5 KB

Features

Describe the feature collection with Id `collectionId`

A single Feature Collection for the given if collectionId. Request this endpoint to get a full list of metadata for the Feature Collection.

get/collections/{collectionId}

Path parameters

collectionIdstring required

local identifier of a collection

Response

Information about the feature collection with id collectionId.

The response contains a link to the items in the collection (path /collections/{collectionId}/items, link relation items) as well as key information about the collection. This information includes:

A local identifier for the collection that is unique for the dataset;
A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude);
An optional title and description for the collection;
An optional extent that can be used to provide an indication of the spatial and temporal extent of the collection - typically derived from the data;
An optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature').

stac_versionstring required

typestring required

idstring required

identifier of the collection used, for example, in URIs

titlestring

human readable title of the collection

descriptionstring required

Detailed multi-line description to fully explain the catalog or collection. CommonMark 0.29 syntax MAY be used for rich text representation.

keywordsstring[]

List of keywords describing the collection.

licensestring required

License(s) of the data as a SPDX License identifier. Alternatively, use proprietary if the license is not on the SPDX license list or various if multiple licenses apply. In these two cases links to the license texts SHOULD be added, see the license link relation type.

Non-SPDX licenses SHOULD add a link to the license text with the license relation in the links section. The license text MUST NOT be provided as a value of this field. If there is no public license URL available, it is RECOMMENDED to host the license text and link to it.

summariesobject

Summaries are either a unique set of all available values or statistics. Statistics by default only specify the range (minimum and maximum values), but can optionally be accompanied by additional statistical values. The range can specify the potential range of values, but it is recommended to be as precise as possible. The set of values must contain at least one element and it is strongly recommended to list all values. It is recommended to list as many properties as reasonable so that consumers get a full overview of the Collection. Properties that are covered by the Collection specification (e.g. providers and license) may not be repeated in the summaries.

Example response

{
  "stac_version": "1.1.0",
  "stac_extensions": [],
  "type": "Collection",
  "id": "Sentinel-2",
  "title": "Sentinel-2 MSI: MultiSpectral Instrument, Level-1C",
  "description": "Sentinel-2 is a wide-swath, high-resolution, multi-spectral\nimaging mission...\n",
  "license": "proprietary",
  "keywords": [
    "copernicus",
    "esa",
    "eu",
    "msi",
    "radiance",
    "sentinel"
  ],
  "providers": [
    {
      "name": "ESA",
      "roles": [
        "producer",
        "licensor"
      ],
      "url": "https://sentinel.esa.int/web/sentinel/user-guides/sentinel-2-msi"
    }
  ],
  "extent": {
    "spatial": {
      "bbox": [
        [
          -180,
          -56,
          180,
          83
        ]
      ]
    },
    "temporal": {
      "interval": [
        [
          "2015-06-23T00:00:00Z",
          "2019-07-10T13:44:56Z"
        ]
      ]
    }
  },
  "summaries": {
    "datetime": {
      "min": "2015-06-23T00:00:00Z",
      "max": "2019-07-10T13:44:56Z"
    },
    "sci:citation": [
      "Copernicus Sentinel data [Year]"
    ],
    "eo:gsd": [
      10,
      30,
      60
    ],
    "platform": [
      "sentinel-2a",
      "sentinel-2b"
    ],
    "constellation": [
      "sentinel-2"
    ],
    "instruments": [
      "msi"
    ],
    "view:off_nadir": {
      "min": 0,
      "max": 100
    },
    "view:sun_elevation": {
      "min": 6.78,
      "max": 89.9
    },
    "eo:bands": [
      [
        {
          "name": "B1",
          "common_name": "coastal",
          "center_wavelength": 4.439
        },
        {
          "name": "B2",
          "common_name": "blue",
          "center_wavelength": 4.966
        },
        {
          "name": "B3",
          "common_name": "green",
          "center_wavelength": 5.6
        },
        {
          "name": "B4",
          "common_name": "red",
          "center_wavelength": 6.645
        },
        {
          "name": "B5",
          "center_wavelength": 7.039
        },
        {
          "name": "B6",
          "center_wavelength": 7.402
        },
        {
          "name": "B7",
          "center_wavelength": 7.825
        },
        {
          "name": "B8",
          "common_name": "nir",
          "center_wavelength": 8.351
        },
        {
          "name": "B8A",
          "center_wavelength": 8.648
        },
        {
          "name": "B9",
          "center_wavelength": 9.45
        },
        {
          "name": "B10",
          "center_wavelength": 1.3735
        },
        {
          "name": "B11",
          "common_name": "swir16",
          "center_wavelength": 1.6137
        },
        {
          "name": "B12",
          "common_name": "swir22",
          "center_wavelength": 2.2024
        }
      ]
    ]
  },
  "links": [
    {
      "rel": "self",
      "href": "http://cool-sat.com/collections/Sentinel-2"
    },
    {
      "rel": "root",
      "href": "http://cool-sat.com/collections"
    },
    {
      "rel": "license",
      "href": "https://scihub.copernicus.eu/twiki/pub/SciHubWebPortal/TermsConditions/Sentinel_Data_Terms_and_Conditions.pdf",
      "title": "Legal notice on the use of Copernicus Sentinel Data and Service Information"
    },
    {
      "rel": "queryables",
      "href": "http://cool-sat.com/collections/Sentinel-2/queryables",
      "title": "queryables for this collection"
    }
  ]
}