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

POSThttps://api.radiantdrift.com/elevation
Authorization
Query parameters
Body

An array of Topocentric Coordinates. Each element contains lat, lng

latnumber
lngnumber
Response
Body
query*object
response*object
Request
const response = await fetch('https://api.radiantdrift.com/elevation', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      [
        {
          "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
        }
      ]
    ]),
});
const data = await response.json();
Response
{
  "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.

Last updated