Spatial Queries

Nearest neighbor query

Find the nearest features in a dataset to a given point, sorted by distance. Returns geodesic distance in meters and miles. Distance is measured to the nearest edge of each polygon (not centroid).

get/v1/nearest

Request

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

Query parameters

latnumber required

Latitude (WGS84).

lngnumber required

Longitude (WGS84).

system_datasetstring

System dataset slug (e.g., "us-counties"). Exactly one of system_dataset, dataset, or dataset_id is required.

datasetstring

User dataset slug. Exactly one of system_dataset, dataset, or dataset_id is required.

dataset_idstring uuid

User dataset UUID. Exactly one of system_dataset, dataset, or dataset_id is required.

versioninteger

Specific dataset version to query. Defaults to the latest version.

ninteger

Number of nearest features to return (max 20).

radiusnumber

Maximum search radius in meters (max 500,000 m / 500 km).

Response

Query result.

matchboolean required

True if at least one nearest feature was found.

datasetstring required
versioninteger required
latency_msnumber required
api_versionstring required
semantics_versionstring required

Changes

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