Skip to content
GuidesPlaygroundDashboard

Look up elevation for multiple coordinates

POST/api/v1/elevation/batch

Look up elevation for multiple coordinates

Body ParametersJSONExpand Collapse
geometry: GeoJsonGeometry { 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)

One of the following:
array of number
array of array of number
array of array of array of number
array of array of array of array of number
type: "Point" or "LineString" or "Polygon" or 3 more
One of the following:
"Point"
"LineString"
"Polygon"
"MultiPoint"
"MultiLineString"
"MultiPolygon"
ReturnsExpand Collapse
ElevationBatchResult = 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: GeoJsonGeometry { 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)

One of the following:
array of number
array of array of number
array of array of array of number
array of array of array of array of number
type: "Point" or "LineString" or "Polygon" or 3 more
One of the following:
"Point"
"LineString"
"Polygon"
"MultiPoint"
"MultiLineString"
"MultiPolygon"
properties: object { elevation_m }
elevation_m: optional number

Elevation in meters above mean sea level

type: "Feature"
type: "FeatureCollection"

Look up elevation for multiple coordinates

curl https://plaza.fyi/api/v1/elevation/batch \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $PLAZA_API_KEY" \
    -d '{
          "geometry": {
            "coordinates": [
              0
            ],
            "type": "Point"
          }
        }'
Returns Examples