api.radiantdrift.com
  • Radiant Drift API
    • Subscription Plans
    • Educational Use and Research
    • API End Points
  • Getting Started
    • About your account
    • Request Authentication
    • Managing API Keys
    • OpenAPI Specification
    • Date/Time Format
    • Validity, Accuracy, and Precision
  • Usage Guidelines
    • Acceptable Use Policy
    • Usage Credits and Call Costs
    • Attribution
    • Rate Limits
  • Julian Day
  • Delta-T
  • Rise, Transit, Set Times
  • Body Position
    • Request Parameters
    • Position at a given time
    • Positions for a time range
    • Observer location
  • Solar Eclipses
    • Embeddable Web Widgets
      • Eclipse Map
      • Eclipse Simulator
    • Besselian Elements
    • Local Circumstances
    • Eclipse Paths
    • Five Millennium Canon of Solar Eclipses
  • The Moon
    • Lunar Libration
    • Lunar Limb Profile
  • Geospatial
    • Geodesic
    • Elevation
  • Reference
    • Definitions
    • Errors
Powered by GitBook
On this page
  1. Geospatial

Elevation

Determine the elevation above sea level for given coordinates

PreviousGeodesicNextReference

Last updated 12 months ago

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 data set.

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.

Terrain Tiles
  • Data Source
  • POSTGet the elevation values for a given array of lat,lng pairs
  • Attribution

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
4XX
Not Found
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
      ]
    ]
  }
}