Skip to main content

pydggsapi

Version

A python FastAPI OGC DGGS API implementation

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).

Metadata

Release files for pydggsapi 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pydggsapi 0.4.0
File Size Uploaded
pydggsapi-0.4.0.tar.gz 53.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pydggsapi 0.4.0
File Interpreter ABI Platform
pydggsapi-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 127.4 kB

Release files / pydggsapi-0.4.0.tar.gz

Download URL pydggsapi-0.4.0.tar.gz
Size 53.6 kB
Tags Source
SHA-256 checksum
How to use checksums
55fc4bda282cf55044f801e1dc001827e17a15bbee84c02c6b7e4e6d74aaccf9
BLAKE2b-256 checksum
How to use checksums
c3b4242ff53535ef4dbee278ae2bf1a70c5130740e5c8db10dcbe647161b39d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.

Transparency log

Release files / pydggsapi-0.4.0-py3-none-any.whl

Download URL pydggsapi-0.4.0-py3-none-any.whl
Size 73.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cacd19554e83f76a2c86c7186647da64251815c7f6e4e3fec1b96c65a76a3896
BLAKE2b-256 checksum
How to use checksums
e8ae4065bcee6da131a5bab61c2e25f7c8ea47b4c03909e0c6016597e29a8e02
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.1.5

2 release files

0.1.3

2 release files

0.1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page