DGGRS & Zones
Grids and the cells that make them up. See Collections, DGGRS & Zones for how these relate to collections.
Every route below exists in two forms: a bare /dggs/... form (grid-only, no data) and a /collections/{collection_id}/dggs/... form. Both return the same shape — the collection-scoped form just adds collection-aware links (e.g. back to the collection, or to that zone’s data).
GET /dggs, GET /collections/{collection_id}/dggs
Lists the DGGRS grids available in the registry (currently the same list regardless of collection).
curl https://api.geoinsight.ai/dggsGET /dggs/{dggrs_id}, GET /collections/{collection_id}/dggs/{dggrs_id}
One grid’s description: title, crs, default_depth, max_refinement_level, max_relative_depth, plus link templates for that grid’s zone info and zone data URIs. GeoInsight’s default grid is IVEA7H.
curl https://api.geoinsight.ai/dggs/IVEA7HGET /dggs/{dggrs_id}/zones, GET /collections/{collection_id}/dggs/{dggrs_id}/zones
Lists zone ids covering an area, or the children of a parent zone.
| Param | Description |
|---|---|
bbox | min_lon,min_lat,max_lon,max_lat. On the collection-scoped route, the smaller of this and the collection’s own extent is used. |
zone-level | Resolution to compute zones at. Defaults to the DGGRS’s own default refinement level. |
parent-zone | Return the children of this zone instead of a bbox query. zone-level then means relative depth below the parent. |
compact-zones | Must be omitted or false — this deployment doesn’t implement zone-list compaction and rejects true with a 400. |
refined-geometry | Densify edges with extra interpolated points. Default true on this route. |
f | Format: default DGGS-JSON, plus html, application/geo+json, parquet, geoparquet. |
curl "https://api.geoinsight.ai/dggs/IVEA7H/zones?bbox=-9.15,38.70,-9.10,38.75&zone-level=9"GET /dggs/{dggrs_id}/zones/{zone_id}, GET /collections/{collection_id}/dggs/{dggrs_id}/zones/{zone_id}
One zone: centroid, bbox, area_meters_square, geometry, and links to its parent, children, and neighbors. On the collection-scoped route, also a source link to the underlying data (a STAC item, a raw URL, depending on the collection’s backend) and a link to that zone’s data.
curl https://api.geoinsight.ai/dggs/IVEA7H/zones/{zone_id}refined-geometry defaults to true here (vs. false on Zone Data) — geometry-focused routes densify by default, data routes don’t.