Elevation lookup

Metres above mean sea level for one or many points.

Parameters

The endpoint also accepts POST with a JSON body {"locations": [[lat, lon], ...]} for long lists that would not fit in a URL.

Example

$ curl "https://api.mygeocode.com/v1/elevation?locations=36.2381,-116.8175|31.5590,35.4732"

const points = [[36.2381, -116.8175], [31.5590, 35.4732]];
const url = new URL("https://api.mygeocode.com/v1/elevation");
url.searchParams.set("locations", points.map((p) => p.join(",")).join("|"));

const { results } = await (await fetch(url)).json();
results.forEach((r) => console.log(r.elevation_m));

import requests

points = [(36.2381, -116.8175), (31.5590, 35.4732)]
locations = "|".join(f"{lat},{lon}" for lat, lon in points)
r = requests.get("https://api.mygeocode.com/v1/elevation", params={"locations": locations}, timeout=10)
for item in r.json()["results"]:
    print(item["elevation_m"])

{
  "status": "ok",
  "results": [
    { "lat": 36.2381, "lon": -116.8175, "elevation_m": -85.4, "resolution_m": 30 },
    { "lat": 31.559, "lon": 35.4732, "elevation_m": -430.2, "resolution_m": 30 }
  ]
}

Response fields

Notes

• Values are interpolated between cells. Vertical accuracy is typically within a few metres on open terrain, worse under tree canopy and in dense cities.
• Over water bodies inland (lakes, reservoirs) the value is the surface elevation.
• Elevation does not change. Cache results for as long as you like.
• The Google Elevation, Bing Elevations and Open-Elevation request formats are available on the drop-in hosts.

The same lookup in other providers' formats

If you already have code written against one of these providers, keep it: the drop-in host accepts the same path and parameters and answers in that provider's response shape, with this endpoint behind it. See how the drop-ins work.

Errors

400 invalid_request when neither a point nor locations is given, when a coordinate is out of range or malformed, or when there are more than 100 points.