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
Authorizations
Query parameters
formatstring · enumOptional

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

Default: arrayExample: arrayPossible values:
Body
latnumberOptional
lngnumberOptional
Responses
200Success
application/json
post
POST /elevation HTTP/1.1
Host: api.radiantdrift.com
Content-Type: application/json
Accept: */*
Content-Length: 156

[
  [
    {
      "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
    }
  ]
]
{
  "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.

PreviousGeodesicNextReference

Last updated