Spatial Queries

Location enrichment

Send a location, get back everything Terranode knows about it. Queries one, many, or all datasets in a single call. Each dataset queried counts as one request against the monthly quota. Under the hood, this fans out a spatial join (intersects, match_mode=all) across the selected datasets in parallel.

get/v1/enrich

Request

  • Base URL: https://api.terranode.co
  • URL: https://api.terranode.co/v1/enrich
  • Auth: API key in header x-api-key

Query parameters

latnumber required

Latitude (WGS84).

lngnumber required

Longitude (WGS84).

system_datasetstring

System dataset slug(s), comma-delimited for multiple (e.g., "us-counties,us-states"). Mutually exclusive with dataset and dataset_id. Omit all three for all-dataset mode.

datasetstring

User dataset slug(s), comma-delimited for multiple. Mutually exclusive with system_dataset and dataset_id.

dataset_idstring

Dataset UUID(s), comma-delimited for multiple. Resolves across user and system namespaces. Mutually exclusive with system_dataset and dataset.

radiusnumber

Expand search area by this radius in meters. Without radius, only geometric intersections match. With radius, returns features within distance. Maximum 500,000 m (500 km).

Response

Enrichment result.

radius_mnumber

Echo of the radius parameter, in meters. Omitted when not provided.

latency_msnumber required
api_versionstring required
semantics_versionstring required

Changes

No recorded changes to this operation across all 1 revision of this API.