Quickstart
This walks through one call chain against the live API, from “what data is there” to “give me values for a zone.” None of these calls need a token (the DGGS data surface is open by default). See Authentication for the handful of endpoints that do require one.
Base URL: https://api.geoinsight.ai (a https://api-dev.geoinsight.ai environment exists for testing against non-production data).
List the available collections
Every dataset GeoInsight exposes is a collection. Start here to see what you can query and to get a real collection_id for the next steps.
curl https://api.geoinsight.ai/collectionsPick a collection_id from the response (its id field) and use it below.
curl https://api.geoinsight.ai/collections/{collection_id}Find the grid it’s indexed on
Data is addressed through a DGGRS (Discrete Global Grid Reference System) - GeoInsight’s default is ISEA7H. List the grids available for your collection:
curl https://api.geoinsight.ai/collections/{collection_id}/dggsFor the rest of this walkthrough we’ll use IVEA7H as the dggrs_id.
Get the zones covering an area
A zone is one cell of the grid. Ask for the zones that cover a bounding box (min_lon,min_lat,max_lon,max_lat) at a given resolution:
curl "https://api.geoinsight.ai/collections/{collection_id}/dggs/IVEA7H/zones?bbox=-9.15,38.70,-9.10,38.75&zone-level=9"The response lists the matching zones and their ids. Pick one zone_id from the response for the last step.
Fetch data for a zone
curl "https://api.geoinsight.ai/collections/{collection_id}/dggs/isea3h/zones/{zone_id}/data"This returns the collection’s field values for that zone. Depending on the collection’s underlying source (vector, raster/COG, STAC, or OGC Features), the shape of what comes back differs — the full behavior is covered in the API Reference.
No Authorization header was needed for any of these calls. Almost all of the API is open; See Authentication.