Skip to content
Plaza Plaza Docs
GuidesPlaygroundDashboard
API Reference

Elevation

Look up elevation at one or more points
$ plaza elevation lookup
GET/api/v1/elevation
Look up elevation for multiple coordinates
$ plaza elevation batch
POST/api/v1/elevation/batch
Elevation profile along coordinates
$ plaza elevation profile
POST/api/v1/elevation/profile
ModelsExpand Collapse
elevation_batch_result: object { features, type }

GeoJSON FeatureCollection of elevation Point Features with 3D coordinates

features: array of ElevationLookupResult { geometry, properties, type }

Elevation Point Features for each queried point

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: object { elevation_m }
elevation_m: optional number

Elevation in meters above mean sea level

type: "Feature"
"Feature"
type: "FeatureCollection"
"FeatureCollection"
elevation_lookup_result: object { geometry, properties, type }

GeoJSON Point Feature with 3D coordinate [lng, lat, elevation] (RFC 7946 §3.1.1)

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: object { elevation_m }
elevation_m: optional number

Elevation in meters above mean sea level

type: "Feature"
"Feature"
elevation_profile_request: object { geometry }

Request body for elevation profile

geometry: object { coordinates, type }

Path to profile (GeoJSON LineString geometry, minimum 2 points)

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"
elevation_profile_result: object { geometry, properties, type }

GeoJSON LineString Feature with 3D coordinates representing an elevation profile

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: object { avg_elevation_m, max_elevation_m, min_elevation_m, 2 more }
avg_elevation_m: optional number

Average elevation along profile

max_elevation_m: optional number

Maximum elevation along profile

min_elevation_m: optional number

Minimum elevation along profile

total_ascent_m: optional number

Total elevation gain in meters

total_descent_m: optional number

Total elevation loss in meters

type: "Feature"
"Feature"