Elevation API – Übersicht

Die Elevation API ist ein Dienst, mit dem Höhendaten für einen Ort auf der Erde oder Höhendaten entlang von Pfaden zurückgegeben werden.

Vorteile der Elevation API

Mit der Elevation API können Sie Anwendungen entwickeln, die Ihre Kunden bei höhenempfindlichen Aktivitäten, Positionierungsanwendungen oder Anwendungen zur niedrigen Vermessung unterstützen, die Höhen und Höhenunterschiede entlang von Routen umfassen. Sie können beispielsweise Daten zu Höhenunterschieden und -zuwächsen bereitstellen, um eine Sportanwendung für Aktivitäten wie Wandern, Radfahren oder Tauchen zu verbessern.

Was Sie mit der Elevation API tun können

Mit der Elevation API können Sie Höhendaten in Ihre Anwendungen oder auf eine Karte einfügen. Beispiel:

  • Sie können die Höhe für einen bestimmten Ort abrufen.
  • Berechnen Sie die Höhenunterschiede entlang einer Route oder zwischen zwei Punkten.

Funktionsweise der Elevation API

Die Elevation API akzeptiert eine Anfrage als codierte URL mit Breiten- und Längengradkoordinaten, die entweder als separate Standorte oder als eine Reihe von Standorten entlang eines Pfads bereitgestellt werden. Diese Anfrage fragt beispielsweise die Höhe für das Zentrum von Denver, Colorado, ab und gibt eine Rückgabe im JSON-Format an.
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

Der Dienst leitet die Höhe für die angegebenen Koordinaten ab. Außerdem interpoliert sie die Höhe für einen Standort ohne Höhe und stellt einen Durchschnittswert bereit, der von den vier nächstgelegenen Standorten zurückgegeben wird, die Höhendaten bereitstellen. Schließlich bestimmt er die Gesamtauflösung des Standorts.

Ressourcen

In der folgenden Tabelle sind die über die Elevation API verfügbaren Ressourcen und die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Breiten-/Längengradkoordinaten

Sie können Daten als eine Gruppe von einem oder mehreren Orten oder als Reihe entlang eines Pfads angeben. Sie können auch codierte Koordinaten angeben. Sie können bis zu 512 Koordinaten übergeben.

Die Elevation API gibt Höhen in Metern relativ zum lokalen mittleren Meeresspiegel (Local Mean Sea Level, LLMSL) an. Die Höhe kann wie unten angegeben als positive oder negative Werte zurückgegeben werden:

  • Positive Werte geben Standorte oberhalb von LMSL an, z. B. Standorte an der Oberfläche oder am Grund von hoch gelegenen Seen.
  • Negative Werte kennzeichnen Orte, die unter der LMSL liegen, z. B. Orte auf der Oberfläche oder auf dem Meeresgrund.
  • Resolution gibt die Entfernung zwischen dem Datenpunkt und der Höhe in Metern an.
  • JSON
  • XML

Elevation API verwenden

1 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung für die Einrichtung.
2 Höhenanfragen starten Sobald du einen API-Schlüssel hast, kannst du die Elevation API direkt über deinen Browser testen. Weitere Informationen finden Sie im Startleitfaden unter Beispielanfragen.
3 Komplexere Anfrage verfassen Wenn Sie ein Projekt eingerichtet haben, versuchen Sie es mit einer Anfrage, die Standortdaten entlang eines Pfads bereitstellt. Weitere Informationen finden Sie unter Pfade angeben .
4 Grundlagen zu Antworten Untersuchen Sie die Antworten auf Höhendaten, um die Verwendung von Höhendaten für Ihre App vorzubereiten. Weitere Informationen finden Sie unter Höhenantworten.
5 Binden Sie Höhendaten in Ihre eigene App ein. Sie können Höhendaten verwenden, um standortbasierte Apps zu optimieren, z. B. Apps für Sportaktivitäten oder für Umfragedaten.

Verfügbare Clientbibliotheken

Rufen Sie diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken auf:

Die Java-, Python-, Go- und Node.js-Clients für Google Maps-Dienste sind von der Community unterstützte Clientbibliotheken, die unter der Apache 2.0-Lizenz als Open Source zur Verfügung gestellt werden. Laden Sie sie von GitHub herunter. Dort finden Sie auch eine Installationsanleitung und Beispielcode.

Nächste Schritte