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

radianDriftApiKeyradiantDriftJWT

Query parameters

formatstring · enumOptional

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

Default: arrayExample: arrayAvailable options:

Body

latnumberOptional

lngnumberOptional

Responses

application/json

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

application/json

post

HTTPcURLJavaScriptPython

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.