Die Elevation API liefert Höhendaten für alle Standorte auf der Erdoberfläche, auch für tiefer liegende Standorte auf dem Meeresgrund, die dann negative Werte zurückgeben.
Dieser Dienst ist auch als Teil der clientseitigen Maps JavaScript API oder für die serverseitige Verwendung mit dem Java-Client, Python-Client, Go-Client und Node.js-Client für Google Maps-Dienste verfügbar.
Beispielanforderung und -antwort
Der Zugriff auf die Elevation API erfolgt über eine HTTP-Schnittstelle, wobei Anfragen als URL-String erstellt werden. Dabei werden anhand von Breiten- und Längengradkoordinaten die Standorte oder Pfadeckpunkte identifiziert. Anforderungen müssen Ihren API-Schlüssel enthalten.
Im folgenden Beispiel wird die Höhe für Denver, Colorado, die „Mile High City“, im JSON-Format angefordert:
URL
https://maps.googleapis.com/maps/api/elevation/json ?locations=39.7391536%2C-104.9847034 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'
Sie können dies testen, indem Sie die URL in Ihren Webbrowser eingeben. Ersetzen Sie dabei YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel.
Die Antwort enthält die Höhe an diesem Punkt in Metern sowie den Auflösungswert (die maximale Entfernung zwischen Datenpunkten, von denen aus die Höhe interpoliert wurde, in Metern).
Weitere Informationen zum Erstellen von Anfrage-URLs und verfügbaren Parametern sowie zum Verstehen der Antwort finden Sie im Entwicklerhandbuch.
Hier sehen Sie eine Beispielantwort:
JSON
{
"results":
[
{
"elevation": 1608.637939453125,
"location": { "lat": 39.7391536, "lng": -104.9847034 },
"resolution": 4.771975994110107,
},
],
"status": "OK",
}XML
<ElevationResponse> <status>OK</status> <result> <location> <lat>39.7391536</lat> <lng>-104.9847034</lng> </location> <elevation>1608.6379395</elevation> <resolution>4.7719760</resolution> </result> </ElevationResponse>
Codierung mit unseren Clientbibliotheken
Clientbibliotheken erleichtern die Entwicklung mit den Google Maps Web Service APIs und ermöglichen einfache, native Implementierungen häufiger Aufgaben wie Authentifizierung, Anfragedrosselung und automatische Wiederholungsversuche. Die Elevation API ist als Java-Client, Python-Client, Go-Client und Node.js-Client für Google Maps-Dienste verfügbar.
Authentifizierung, Kontingente, Preise und Richtlinien
Authentifizierung
Wenn Sie die Elevation API verwenden möchten, müssen Sie zuerst die API aktivieren und die erforderlichen Anmeldedaten für die Authentifizierung abrufen. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
Kontingente und Preise
Auf der Seite Nutzung und Abrechnung finden Sie weitere Informationen zu den Kontingenten und Preisen für die Elevation API.
Richtlinien
Die Nutzung der Elevation API muss den API-Richtlinien entsprechen.
Weitere Informationen
Mit der Elevation API haben Sie mehr Möglichkeiten, z. B. Höhendaten von mehreren Standorten anzufordern. Weitere Beispiele und Details finden Sie im Entwicklerleitfaden zur Elevation API.
Der Elevation API-Entwicklerleitfaden richtet sich an Entwickler von Websites und mobilen Anwendungen, die Höhendaten in Karten verwenden möchten, die über eine der Google Maps Platform APIs bereitgestellt werden. Er bietet eine Einführung in die Verwendung der API und Referenzmaterial zu den verfügbaren Parametern.