Collections

Retrieve the list of geospatial data collections available from this service.

get

Responses

200

The collections of (mostly geospatial) data available from this API. The dataset contains one or more collections. This resource provides information about and access to the collections. The response contains the list of collections. Each collection is accessible via one or more OGC API set of specifications, for which a link to relevant accessible resources, e.g. /collections/{collectionId}/(items, coverage, map, tiles...) is provided, with the corresponding relation type, 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 data 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;
• for collections accessible via the Features or Records API, an optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature').

application/jsontext/html

400

The request was not supported.

application/json

404

The requested resource does not exist on the server. For example, a path parameter had an incorrect value.

application/json

405

The HTTP method requested is not supported. This endpoint only supports 'GET' requests.

application/json

406

A request header value was not supported.

application/json

500

A server error occurred.

application/json

504

Gateway Timeout.

application/json

get

HTTPcURLJavaScriptPython

GET /maps/vector/ngd/ota/v1/collections HTTP/1.1
Host: api.os.uk
Accept: */*

{
  "links": [
    {
      "href": "http://data.example.org/collections",
      "rel": "self",
      "type": "application/json",
      "title": "All collections"
    }
  ],
  "collections": [
    {
      "id": "buildingpart",
      "title": "Building Part",
      "description": "Polygon feature representing a building.",
      "extent": {
        "spatial": {
          "bbox": [
            [
              -8.82,
              49.79,
              1.92,
              60.94
            ]
          ]
        },
        "temporal": {
          "interval": [
            [
              "2022-08-27T00:00:00Z",
              null
            ]
          ]
        }
      },
      "links": [
        {
          "href": "http://data.example.org/collections/buildingpart/items",
          "rel": "items",
          "type": "application/geo+json",
          "title": "Building Part"
        }
      ]
    }
  ]
}