Skip to content
Plaza Plaza Docs
GuidesPlaygroundDashboard
API Reference
Elements

Find features near a geographic point

$ plaza elements nearby
GET/api/v1/features/nearby

Find features near a geographic point

ParametersExpand Collapse
--lat: number

Latitude (-90 to 90)

--lng: number

Longitude (-180 to 180)

--limit: optional number

Maximum results (default 20, max 100)

--radius: optional number

Search radius in meters (default 500, max 10000)

ReturnsExpand Collapse
feature_collection: object { features, type }

Bare GeoJSON FeatureCollection. Pagination metadata is returned in HTTP headers (X-Limit, X-Has-More, X-Next-Cursor, X-Next-Offset, Link).

features: array of GeoJsonFeature { geometry, properties, type, 2 more }
geometry: object { coordinates, type }
coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of number

GeoJSON coordinates array (nesting depth varies by geometry type)

union_member_0: array of number
union_member_1: array of array of number
union_member_2: array of array of array of number
union_member_3: array of array of array of array of number
type: "Point" or "LineString" or "Polygon" or 3 more
"Point"
"LineString"
"Polygon"
"MultiPoint"
"MultiLineString"
"MultiPolygon"
properties: map[unknown]
type: "Feature"
"Feature"
id: optional string

Feature identifier (type/osm_id)

osm_id: optional number

OpenStreetMap ID

type: "FeatureCollection"
"FeatureCollection"

Find features near a geographic point

plaza elements nearby \
  --api-key 'My API Key' \
  --lat 0 \
  --lng 0
Returns Examples