Höhenabfrage

Meter über dem mittleren Meeresspiegel für einen oder viele Punkte.

Parameter

Der Endpunkt akzeptiert außerdem POST mit einem JSON-Body {"locations": [[lat, lon], ...]} für lange Listen, die nicht in eine URL passen würden.

Beispiel

$ curl -H "X-API-Key: YOUR_KEY" "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, { headers: { "X-API-Key": "YOUR_KEY" } })).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}, headers={"X-API-Key": "YOUR_KEY"}, timeout=10)
for item in r.json()["results"]:
    print(item["elevation_m"])

{
  "status": "ok",
  "results": [
    { "lat": 36.2381, "lon": -116.8175, "elevation_m": -82.0, "resolution_m": 463.8 },
    { "lat": 31.559, "lon": 35.4732, "elevation_m": -416.0, "resolution_m": 463.8 }
  ]
}

Antwortfelder

Hinweise

• Die Werte stammen aus der nächstgelegenen Zelle eines Rasters mit 15 Bogensekunden (etwa 460 m), weltweit, Land und Meeresboden. Erwarten Sie die Höhe des umgebenden Geländes statt einer punktgenauen Höhe: gut geeignet für Profile, Einzugsgebiete, Funkstrecken und Plausibilitätsprüfungen, zu grob für ein einzelnes Gebäude oder einen schmalen Grat. Die vertikale Genauigkeit liegt in sanftem Gelände typischerweise bei wenigen Metern und in steilen Gebirgen bei einigen zehn Metern.
• Über Binnengewässern (Seen, Stauseen) ist der Wert die Höhe der Wasseroberfläche.
• Die Höhe ändert sich nicht. Speichern Sie Ergebnisse so lange zwischen, wie Sie möchten.
• Die Anfrageformate von Google Elevation, Bing Elevations und Open-Elevation sind auf den Drop-in-Hosts verfügbar.

Dieselbe Abfrage in den Formaten anderer Anbieter

Wenn Sie bereits Code für einen dieser Anbieter geschrieben haben, behalten Sie ihn: Der Drop-in-Host akzeptiert denselben Pfad und dieselben Parameter und antwortet in der Antwortstruktur dieses Anbieters, mit diesem Endpunkt dahinter. Siehe So funktionieren die Drop-in-Hosts.

Fehler

400 invalid_request, wenn weder ein Punkt noch locations angegeben ist, wenn eine Koordinate außerhalb des gültigen Bereichs liegt oder fehlerhaft ist, wenn es mehr als 100 Punkte sind oder wenn samples, rows oder cols mehr als 100 ergeben würden. 503 backend_unavailable, wenn der Höhendienst nicht antwortet; es wird nichts gezählt.