Skip to content
GuidesBlogPlaygroundDashboard

Look up elevation for multiple coordinates

$client->elevation->batch(list<Coordinate> coordinates, ?string format): ElevationBatchResult
POST/api/v1/elevation/batch

Look up elevation for multiple coordinates

ParametersExpand Collapse
coordinates: list<Coordinate>

Coordinates to look up elevations for (max 50)

format?:optional string

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

ReturnsExpand Collapse
list<ElevationLookupResult> features

Elevation results in the same order as input coordinates

Type type

Look up elevation for multiple coordinates

<?php

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

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

$elevationBatchResult = $client->elevation->batch(
  coordinates: [
    ['lat' => 48.8566, 'lng' => 2.3522], ['lat' => 45.764, 'lng' => 4.8357]
  ],
  format: 'format',
);

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