Los gehts

Über die Elevation API erhalten Sie Höhendaten für alle Standorte auf der Oberfläche der Erde und auch für tiefer liegende Orte auf dem Meeresgrund, 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 den Java-, Python-, Go- und Node.js-Clients für Google Maps-Dienste verfügbar.

Beispielanforderung und -antwort

Der Zugriff auf die Elevation API erfolgt über eine HTTP-Schnittstelle. Die Anfragen werden als URL-String erstellt, wobei die Standorte oder Pfadscheitelpunkte anhand von Breiten- und Längengraden identifiziert werden. 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 zu verfügbaren Parametern sowie zum Verstehen der Antwort finden Sie 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>
</pre>

Codierung mit unseren Clientbibliotheken

Clientbibliotheken erleichtern die Entwicklung mit den Google Maps-Webdienst-APIs, da sie integrierte Implementierungen für gängige Aufgaben wie Authentifizierung, Anfrage-Drosselung 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

Damit Sie die Elevation API verwenden können, müssen Sie sie zuerst aktivieren und die entsprechenden Authentifizierungsdaten 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 für die Elevation API.

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 Details finden Sie im Entwicklerhandbuch zur Elevation API.

Der Entwicklerhandbuch für die Elevation API richtet sich an Website- und Mobilentwickler, 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 Referenzmaterial zu den verfügbaren Parametern.