Die Elevation API bietet Höhendaten für alle Standorte auf der Erdoberfläche, einschließlich der Tiefenpositionen auf dem Meeresboden, die dann als negative Werte zurückgegeben werden.
Dieser Dienst ist auch als Teil der clientseitigen Maps JavaScript API oder für die serverseitige Verwendung mit dem Java-, Python-, Go- und Node.js-Client für Google Maps-Dienste verfügbar.
Beispielanforderung und -antwort
Sie greifen über eine HTTP-Schnittstelle auf die Elevation API zu. Anfragen werden als URL-String erstellt und verwenden Breiten-/Längengradkoordinaten, um die Standorte oder Pfadknoten zu identifizieren. Anforderungen müssen Ihren API-Schlüssel enthalten.
Im folgenden Beispiel wird die Höhe von Denver, Colorado, der „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'
Du kannst das testen, indem du die URL in deinen Webbrowser eingibst. Ersetze dabei YOUR_API_KEY durch deinen tatsächlichen API-Schlüssel.
Die Antwort enthält die Höhe an diesem Punkt in Metern sowie den Auflösungswert (die maximale Entfernung in Metern zwischen den Datenpunkten, von denen aus die Höhe interpoliert wurde).
Weitere Informationen zum Erstellen von Anfrage-URLs und verfügbaren Parametern sowie zur Aufschlüsselung der Antwort findest du im Entwicklerhandbuch.
Hier ist 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 Webservice-APIs, da sie einfache, native Implementierungen gängiger Aufgaben wie Authentifizierung, Drosselung von Anfragen und automatische Wiederholungsversuche bieten. Die Elevation API ist im Java-, Python-, Go- 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 entsprechenden Anmeldedaten abrufen. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
Kontingente und Preise
Auf der Seite Nutzung und Abrechnung finden Sie Details zu den Kontingenten und Preisen, die für die Elevation API festgelegt wurden.
Richtlinien
Die Nutzung der Elevation API muss den API-Richtlinien entsprechen.
Weitere Informationen
Mit der Elevation API können Sie noch mehr tun, z. B. Höhendaten von mehreren Standorten anfordern. Weitere Beispiele und Informationen finden Sie im Entwicklerleitfaden für die Elevation API.
Der Entwicklerleitfaden für die Elevation API richtet sich an Entwickler von Websites und mobilen Apps, die Höhendaten in Karten verwenden möchten, die von einer der Google Maps Platform APIs bereitgestellt werden. Sie enthält eine Einführung in die Verwendung der API und Referenzmaterialien zu den verfügbaren Parametern.