Skip to content
Plaza Plaza Docs
GuidesBlogPlaygroundDashboard
API Reference
Elevation

Look up elevation at one or more points

$client->elevation->lookupPost(?string format, ?float lat, ?float lng, ?string locations, ?string outputFields, ?string outputInclude, ?int outputPrecision): ElevationLookupResult
POST/api/v1/elevation

Look up elevation at one or more points

ParametersExpand Collapse
format?:optional string

Response format: json (default), geojson, csv, ndjson

lat?:optional float

Latitude (single point)

lng?:optional float

Longitude (single point)

locations?:optional string

Pipe-separated lng,lat pairs (batch)

outputFields?:optional string

Comma-separated property fields to include

outputInclude?:optional string

Extra computed fields: bbox, center

outputPrecision?:optional int

Coordinate decimal precision (1-15, default 7)

ReturnsExpand Collapse
GeoJsonGeometry geometry

GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.

Properties properties
Type type

Look up elevation at one or more points

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'My API Key', environment: 'local');

$elevationLookupResult = $client->elevation->lookupPost(
  format: 'format',
  lat: 0,
  lng: 0,
  locations: 'locations',
  outputFields: 'output[fields]',
  outputInclude: 'output[include]',
  outputPrecision: 0,
);

var_dump($elevationLookupResult);
{
  "geometry": {
    "coordinates": [
      2.3522,
      48.8566
    ],
    "type": "Point"
  },
  "properties": {
    "elevation_m": 35.2
  },
  "type": "Feature"
}
Returns Examples
{
  "geometry": {
    "coordinates": [
      2.3522,
      48.8566
    ],
    "type": "Point"
  },
  "properties": {
    "elevation_m": 35.2
  },
  "type": "Feature"
}