Spatial Queries

Point-in-polygon query

Test whether a point falls inside any polygon in the specified dataset. Returns all matching polygons with their properties. When no match is found, optionally returns the nearest polygon with distance.

get/v1/pip

Request

  • Base URL: https://api.terranode.co
  • URL: https://api.terranode.co/v1/pip
  • 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.

Response

Query result.

matchboolean required

True if the point is inside at least one polygon.

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.