Skip to content
GuidesPlaygroundDashboard

Fetch multiple features by type and ID

$ plaza elements batch
POST/api/v1/features/batch

Fetch multiple features by type and ID

ParametersExpand Collapse
--element: array of object { id, type }
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"

Fetch multiple features by type and ID

plaza elements batch \
  --api-key 'My API Key' \
  --element '{id: 0, type: node}'
Returns Examples