Elevation

Determine the elevation above sea level for given coordinates

This API is available on the Pro plan or higher

Query the elevation above sea level for a given coordinate or coordinates with the /elevation end point. Post an array of one or more lat/lng coordinates to obtain the elevation above sea level at the given point.

The end point can return three format response types, based on the format query parameter value:

• geojson: a valid GeoJSON document

• array: an array of elevations not including the corresponding lat/lng coordinate (array order is preserved in the response)

• topocentric-array: an array of [lat, lng, elevation] values

Data Source

Elevation data is obtained from the public Terrain Tiles data set.

Get the elevation values for a given array of lat,lng pairs

post

/elevation

Authorizations

radianDriftApiKeyradiantDriftJWT

Query parameters

formatstring · enum · default: array

Output format, should be "geojson", "array" or "topocentric-array". (Default: "array")

Example: array

Options: geojson, array, topocentric-array

Body

latnumber

lngnumber

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.radiantdrift.com/elevation' \
  --header 'Content-Type: application/json' \
  --data '[
    [
      {
        "lat": 45.4,
        "lng": -88.5
      },
      {
        "lat": 46,
        "lng": -86.4
      },
      {
        "lat": 44.2,
        "lng": -85.8
      }
    ],
    [
      {
        "lat": 43.5,
        "lng": -85.7
      },
      {
        "lat": 42.7,
        "lng": -80.45
      },
      {
        "lat": 44.95,
        "lng": -78.73
      }
    ]
  ]'

200

4XX

200

{
  "query": {
    "name": "elevation",
    "tilesetSize": 6,
    "zoomLevel": 15,
    "cost": 6
  },
  "response": {
    "elevation": [
      [
        415.128906,
        209.785156,
        273.554688
      ],
      [
        273.859375,
        209.839844,
        330.390625
      ]
    ]
  }
}

Attribution

Elevation data courtesy of:

• ArcticDEM terrain data DEM(s) were created from DigitalGlobe, Inc., imagery and funded under National Science Foundation awards 1043681, 1559691, and 1542736;

• Australia terrain data © Commonwealth of Australia (Geoscience Australia) 2017;

• Austria terrain data © offene Daten Österreichs – Digitales Geländemodell (DGM) Österreich;

• Canada terrain data contains information licensed under the Open Government Licence – Canada;

• Europe terrain data produced using Copernicus data and information funded by the European Union - EU-DEM layers;

• Global ETOPO1 terrain data U.S. National Oceanic and Atmospheric Administration

• Mexico terrain data source: INEGI, Continental relief, 2016;

• New Zealand terrain data Copyright 2011 Crown copyright (c) Land Information New Zealand and the New Zealand Government (All rights reserved);

• Norway terrain data © Kartverket;

• United Kingdom terrain data © Environment Agency copyright and/or database right 2015. All rights reserved;

• United States 3DEP (formerly NED) and global GMTED2010 and SRTM terrain data courtesy of the U.S. Geological Survey.