API and web services

OrionGIS is built on open standards so your data works with the tools you already use. Three read interfaces are available to developers and desktop GIS users.

Using QGIS? The free Orion Connect plugin searches OrionGIS and adds layers for you, without typing service URLs.

Catalogue API access and OGC services are included from the Pro plan (read) and the Organisation plan (read and write). See Plans and billing.

#Authentication

The endpoints on this page read public or published resources and need no API key. Restricted datasets need a session or an OAuth2 bearer token. If a request returns 403, ask for access through Contact Admin in the sidebar or the contact page.

#Catalogue REST API

The catalogue is served by a REST API. List and filter datasets:

GET https://orionterrametrics.com/api/v2/datasets/?filter{title.icontains}=roads&page_size=20

and fetch one dataset's full metadata, including its attribute schema and extent, by ID:

GET https://orionterrametrics.com/api/v2/datasets/{id}/

#OGC web services

Every published dataset is also served as an OGC web service, so it drops into QGIS, ArcGIS and any other client that speaks OGC.

GET https://orionterrametrics.com/geoserver/ows?service=WMS&request=GetCapabilities
GET https://orionterrametrics.com/geoserver/ows?service=WFS&request=GetFeature&typeNames={layer}&outputFormat=application/json
GET https://orionterrametrics.com/geoserver/ows?service=WCS&request=GetCoverage&coverageId={layer}

• WMS renders the dataset as a map layer.
• WFS returns raw features as GeoJSON, for vector datasets.
• WCS returns raw pixels, for raster datasets.

Each dataset's page has ready-made, copyable URLs for its own layer under Web services.

#Semantic search

You can also search the catalogue by meaning rather than exact keywords. The response is a ranked list of dataset IDs with a similarity score between 0 and 1:

GET https://orionterrametrics.com/orion-core-api/api/v1/search?q=malaria+health+facilities&limit=10

#Fair use

These are shared, best-effort endpoints. Cache responses on your side and avoid tight polling loops. For a bulk export or a recurring integration, contact us first so we can plan for the load.

#Interactive reference

The API Docs entry in the sidebar shows the same endpoints with example requests.

#Need help integrating?

Tell us what you're connecting via the contact page.