OGC API - Discrete Global Grid Systems

The draft OGC API - Discrete Global Grid Systems standard specifies an API for accessing data organised according to a Discrete Global Grid System (DGGS). A DGGS is a spatial reference system that uses a hierarchical tessellation of cells to partition and address the globe. DGGS are characterized by the properties of their cell structure, geo-encoding, quantization strategy and associated mathematical functions.

The API has been designed as a profile of two other OGC APIs:

• OGC API - Features
• OGC API - Processes

NOTE: In the future, a single interface may emerge as the preferred option. This will be determined during development of the candidate standard.

Overview of the OGC API - Discrete Global Grid Systems interface based on OGC API - Features

GET /

Retrieves the landing page. The purpose of the landing page is to provide clients with a starting point for using the API. Any resource exposed through an API can be accessed by following paths or links starting from the landing page.

GET /conformance

Provides a list declaring the modules that are implemented by the API. These modules are referred to as Conformance Classes. The list of Conformance Classes is key to understanding and using an OGC Web API.

GET /collections

The list of supported collections.

GET /collections/{collectionId}

Describes a particular Feature Collection

GET /collections/{collectionId}/items

Access the list of Features within a Collection. Can list either all the Features, or a particular subset based on a, WGS84 bbox, a coarse DGGS CellID (equivalent to a bbox), or a DGGS quadrilateral specified by two DGGS CellIDs (equivalent to a bbox)

GET /collections/{collectionId}/items/{itemId}

Access the definition of a particular Feature

Overview of the OGC API - Discrete Global Grid Systems interface based on OGC API - Processes

GET /

Retrieves the landing page. The purpose of the landing page is to provide clients with a starting point for using the API. Any resource exposed through an API can be accessed by following paths or links starting from the landing page.

GET /conformance

Provides a list declaring the modules that are implemented by the API. These modules are referred to as Conformance Classes. The list of Conformance Classes is key to understanding and using an OGC Web API.

GET /collections

The list of supported collections.

GET /collections/{collectionId}

Describes a particular DGGS

GET /collections/{collectionId}/zones

Access the list of zones in a given DGGS. Can list either all the zones, or a particular subset based on resolution, WGS84 bbox, or list of containing zones (e.g., polygon defined in DGGS terms)

GET /collections/{collectionId}/zones

Access the definition of a particular zone.

GET /collections/{collectionId}/neighbors

Get the list of neighboring zones, to a given zone.

GET /collections/{collectionId}/parents

Get the list of parent zones, to a given zone.

GET /collections/{collectionId}/children

Get the list of child zones, to a given zone.

GET /collections/{collectionId}/point

Returns the id of the zone containing the given point, at the given resolution.

GET /collections/{collectionId}/polygon

Lists zones contained in the polygon.