OGC API - Discrete Global Grid Systems

(back to OGC API - DGGS resources)

OGC API - DGGS specifies an API for accessing data organised according to Discrete Global Grid Reference Systems (DGGRS).

Overview of the OGC API - Discrete Global Grid Systems interface

The following transportable end-point resources can be attached either to an OGC API dataset (as defined by OGC API - Common - Part 1: Core) or to an OGC API collection (as defined by OGC API - Common - Part 2: Geospatial data).

GET .../dggs

List of Discrete Global Grid Reference Systems (DGGRS)

GET .../dggs/{dggrsID}

Description of the DGGRS, providing links to the definition of the DGGRS it implements, which consists of a specific hierarchy of Discrete Global Grids, a Zone Identifier Reference System (ZIRS) and a deterministic ordering of sub-zones. The description also includes links to the data retrieval mechanism and zone query end-points. The DGGRS definition describes the parameters and structure of its DGGH and ZIRS as specified by (ISO/19170-1), as well as a deterministic sub-zone order.

GET .../dggs/{dggrsID}/zones

Query the list of zones where data is available and/or match certain query criteria (e.g., a bounding box, a CQL2 filter), for a selected DGGRS, optionally specifying a particular DGGS hierarchy level (zone-level). This end-point supports a compact representation based on zone hierarchy (compact-zones=true, the default), as well a parent-zone parameter allowing to progressively explore the hierarchy to avoid potentially large responses. In addition to a simple JSON response, implementations can also support others such as a 64-bit integer binary response.

GET .../dggs/{dggrsId}/zones/{zoneId}

Information about a specific zone for a specific DGGRS, such as its geometry and area.

GET .../dggs/{dggrsId}/zones/{zoneId}/data

Retrieve the data for a specific zone of a particular DGGRS, at a resolution corresponding to the DGGS hierarchy level of that zone, in one or more available data packet encodings. Typically, the data packet would include values for descendent zones at a number of levels deeper than the requested zone's level (zone-depth parameter), as opposed to a single value for the requested zone. See the DGGS-JSON schema in particular as well as the associated UB-JSON encoding requirement class.