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.
