OGC API — Processes · process
zone-query
Asynchronous zone query — a web view of GET /api/processes/zone-query.
Enumerate every zone intersecting a geographic spacetime extent and persist the result as a content-addressed zoneSet; the job result carries the zoneSetId handle. Use for results beyond the synchronous endpoint's stored-zoneSet cap.
Inputs
| Name | Type | Default | Description |
|---|---|---|---|
| dggrs | — | Identifier of the discrete global grid reference system to index into or query against. | |
| bbox | — | OGC:CRS84 west,south,east,north or 6-coordinate with heights; or a collection reference whose extent is used. | |
| index-cover | — | When true, the stored zoneSet's cover terms are written so the result is discoverable by later spatial search. Off by default: indexing costs write time and is wasted on a one-off query. | |
| datetime | — | RFC 3339 instant or start/end interval; or a collection reference whose temporal extent is used. | |
| zdepth | — | Ellipsoidal height range hmin/hmax (m). | |
| zone-level | — | DGGS hierarchy level at which zones are enumerated. | |
| height_datum | — | Datum of ALL heights in this request (feature properties and static defaults alike). 'AMSL' (aliases msl/orthometric) converts to ellipsoidal via the geoid model before indexing: h_ell = H_amsl + N(lon,lat), N evaluated at each feature's horizontal centre. | |
| geoid_model | — | Geoid model name (file stem in HYPLICA_GEOID_DIR or the bundled fallback). Default: best available, preferring egm2008 > egm96. Regional models (e.g. GEOID18 for CONUS) are selected the same way. |
Outputs
| Name | Type |
|---|---|
| zoneSetId | |
| zoneSetUrl | |
| total |
API
GET /api/processes/zone-query
POST …/execution
Open in Swagger UI
Execution is asynchronous (returns a job to poll) and requires a token — see the documentation. Track runs under OGC API — Jobs.