Skip to content

Collections

Collections

Operation ID: getCollections
Authorization: None

Query parameters

f string
The optional f parameter indicates the output format which the server shall provide as part of the response document. The default format is GeoJSON. Allowed values: `json`, `html`, `jsonld`. Default: `json`.
lang string
The optional lang parameter instructs the server return a response in a certain language, if supported. If the language is not among the available values, the Accept-Language header language will be used if it is supported. If the header is missing, the default server language is used. Note that providers may only support a single language (or often no language at all), that can be different from the server language. Language strings can be written in a complex (e.g. "fr-CA,fr;q=0.9,en-US;q=0.8,en;q=0.7"), simple (e.g. "de") or locale-like (e.g. "de-CH" or "fr_BE") fashion. Allowed values: `en-US`, `fr-CA`. Default: `en-US`.

Responses

The feature collections shared by this API.

The dataset is organized as one or more feature collections. This resource provides information about and access to the collections.

The response contains the list of collections. For each collection, 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').

Content type: application/json

Schema: ogcapi-features-1__collections

Properties

Property Type Required Description
links array of ogcapi-features-1__link Yes —
collections array of ogcapi-features-1__collection Yes —

Example

{
  "links": [
    {
      "href": "http://data.example.org/collections.json",
      "rel": "self",
      "type": "application/json",
      "title": "this document"
    },
    {
      "href": "http://data.example.org/collections.html",
      "rel": "alternate",
      "type": "text/html",
      "title": "this document as HTML"
    },
    {
      "href": "http://schemas.example.org/1.0/buildings.xsd",
      "rel": "describedby",
      "type": "application/xml",
      "title": "GML application schema for Acme Corporation building data"
    },
    {
      "href": "http://download.example.org/buildings.gpkg",
      "rel": "enclosure",
      "type": "application/geopackage+sqlite3",
      "title": "Bulk download (GeoPackage)",
      "length": 472546
    }
  ],
  "collections": [
    {
      "id": "buildings",
      "title": "Buildings",
      "description": "Buildings in the city of Bonn.",
      "extent": {
        "spatial": {
          "bbox": [
            [
              7.01,
              50.63,
              7.22,
              50.78
            ]
          ]
        },
        "temporal": {
          "interval": [
            [
              "2010-02-15T12:34:56Z",
              null
            ]
          ]
        }
      },
      "links": [
        {
          "href": "http://data.example.org/collections/buildings/items",
          "rel": "items",
          "type": "application/geo+json",
          "title": "Buildings"
        },
        {
          "href": "http://data.example.org/collections/buildings/items.html",
          "rel": "items",
          "type": "text/html",
          "title": "Buildings"
        },
        {
          "href": "https://creativecommons.org/publicdomain/zero/1.0/",
          "rel": "license",
          "type": "text/html",
          "title": "CC0-1.0"
        },
        {
          "href": "https://creativecommons.org/publicdomain/zero/1.0/rdf",
          "rel": "license",
          "type": "application/rdf+xml",
          "title": "CC0-1.0"
        }
      ]
    }
  ]
}

Content type: text/html

Schema: string

Example

string

A query parameter has an invalid value.

Content type: application/json

Schema: ogcapi-features-1__exception

Properties

Property Type Required Description
code string Yes —
description string No —

Example

{
  "code": "string",
  "description": "string"
}

Content type: text/html

Schema: string

Example

string

A server error occurred.

Content type: application/json

Schema: ogcapi-features-1__exception

Properties

Property Type Required Description
code string Yes —
description string No —

Example

{
  "code": "string",
  "description": "string"
}

Content type: text/html

Schema: string

Example

string