Los gehts

Die Elevation API bietet Höhendaten für alle Standorte auf der Erdoberfläche, einschließlich der Tiefenpositionen auf dem Meeresboden (die negative Werte zurückgeben).

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 mit Breiten- und Längengradkoordinaten erstellt, um die Orte oder Pfadpunkte zu identifizieren. 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. Achten Sie darauf, YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel zu ersetzen. 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 Verarbeiten 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 allgemeiner Aufgaben wie Authentifizierung, Anforderungsdrosselung 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 sie zuerst aktivieren und die entsprechenden Authentifizierungsanmeldedaten abrufen. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.

Kontingente und Preise

Details zu den für die Elevation API festgelegten Kontingenten und Preisen finden Sie auf der Seite Nutzung und Abrechnung.

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 andere Details finden Sie im Entwicklerleitfaden für die Elevation API.

Der Entwicklerleitfaden für die Elevation API richtet sich an Website- und mobile Entwickler, die Höhendaten in Karten verwenden möchten, die von einer der Google Maps Platform-APIs bereitgestellt werden. Hier finden Sie eine Einführung in die Verwendung der API und Referenzmaterial zu den verfügbaren Parametern.