Skip to content

Repository files navigation

pydggsapi

Version

A python FastAPI OGC DGGS API implementation

Paper published in the SoftwareX journal: https://doi.org/10.1016/j.softx.2026.103042

Documentations: https://pydggsapi.readthedocs.io/en/latest/

OGC API - Discrete Global Grid Systems

https://ogcapi.ogc.org/dggs/

OGC API - DGGS specifies an API for accessing data organised according to a Discrete Global Grid Reference System (DGGRS). A DGGRS is a spatial reference system combining a discrete global grid hierarchy (DGGH, a hierarchical tessellation of zones to partition) with a zone indexing reference system (ZIRS) to address the globe. Aditionally, to enable DGGS-optimized data encodings, a DGGRS defines a deterministic for sub-zones whose geometry is at least partially contained within a parent zone of a lower refinement level. A Discrete Global Grid System (DGGS) is an integrated system implementing one or more DGGRS together with functionality for quantization, zonal query, and interoperability. DGGS are characterized by the properties of the zone structure of their DGGHs, geo-encoding, quantization strategy and associated mathematical functions.

Setup

Please refer to the Quick Setup section from the documentation for details.

Configration and implementation details

Please refer to the Configuration section from the documentation for details.

Example notebook

Please refer to the Example section from the documentation for demonstration.

Conformance Classes

The API implemented the dggrs-core, zone-query and zone data retrieval, conformal class. The following list shows the conformance classes supported by the API. Users can also refer to the example notebook from the pydggsapi documentation for examples of the query endpoints.

Conformance Class Supported by the API
Core
http://www.opengis.net/spec/ogcapi-common-1/1.0/conf/core ✅
OGC API integration
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/root-dggs ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/collection-dggs ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/operation-ids ❌
For Data Retrieval
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-retrieval ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-subsetting partially: datetime, properties and exclude-properties
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-custom-depths ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-cql2-filter ✅
For Zone Queries
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/zone-query ✅ , query parameter subset and subset-crs is not supported yet
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/zone-query-cql2-filter ✅
Zone Data Encodings
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-json ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-ubjson ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-dggs-jsonfg ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-dggs-ubjsonfg ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-geojson ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-geotiff ❌
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-netcdf ❌
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-coveragejson ❌
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-zarr ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-jpegxl ❌
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/data-png ❌
Zone List Encodings
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/zone-html ❌
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/zone-uint64 ❌
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/zone-geojson ✅
https://www.opengis.net/spec/ogcapi-dggs-1/1.0/conf/zone-geotiff ❌

Acknowledgments

This software is being developed by the Landscape Geoinformatics Lab of the University of Tartu, Estonia.

This work was funded by the Estonian Research Agency (grant number PRG1764, PSG841), Estonian Ministry of Education and Research (Centre of Excellence for Sustainable Land Use (TK232)), and by the European Union (ERC, WaterSmartLand, 101125476 and Interreg-BSR, HyTruck, #C031).

About

A python FastAPI OGC DGGS API implementation

Topics

Resources

Stars

20 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages