Elevation API – Übersicht
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Das Elevation API ist ein Dienst, der Höhendaten für
einen Standort auf der Erde oder Höhendaten entlang von Pfaden.
Vorteile der Elevation API
Mit dem Elevation API können Sie Anwendungen zur Unterstützung Ihrer
Kunden mit höhenempfindlichen Aktivitäten, Positionierungsanwendungen oder wenig Vermessung
die Höhen und Höhenänderungen entlang von Routen umfassen. Beispiel:
können Sie Daten zu Höhenunterschieden und -verlusten bereitstellen, um eine Sport-App für Aktivitäten wie
wie Wandern, Radfahren oder Tauchen.
Möglichkeiten mit der Elevation API
Mit dem Elevation API können Sie Höhendaten in Ihre
oder auf einer Karte darstellen. Beispiel:
- Rufen Sie die Höhe eines bestimmten Ortes ab.
- Höhenunterschiede auf einer Route oder zwischen zwei Routen berechnen
Punkte.
Funktionsweise der Elevation API
Das Elevation API akzeptiert eine Anfrage als codierte URL mit Breiten- und Längengradkoordinaten
als einzelne Standorte oder als eine Reihe von Orten entlang eines Pfads angegeben werden. Diese Anfrage,
z. B. fragt 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 aus den angegebenen Koordinaten ab. Außerdem interpoliert er
Höhe für einen Standort ohne Höhe. Sie ergibt einen Durchschnitt, der aus den vier
nächstgelegene Standorte, für die Höhendaten bereitgestellt werden. Schließlich bestimmt er die Gesamtheit
Auflösung für den Standort.
Ressourcen
In der folgenden Tabelle sind die Ressourcen aufgeführt, die über die
Elevation API zusammen mit den zurückgegebenen Daten an.
| Datenressourcen |
Zurückgegebene Daten |
Rückgabeformat |
| Koordinaten (Breiten- und Längengrad)
Sie können Daten als Gruppe mit einem oder mehreren Standorten oder als Reihe entlang eines Pfads angeben. Ich
können auch codierte Koordinaten bereitstellen. Geben Sie bis zu 512 Koordinaten ein.
|
Die Elevation API stellt Höhen in Metern relativ zur Verfügung.
bis zum lokalen mittleren Meeresspiegel (Local Mean Sea Level, LLMSL). Die Höhe kann positiv zurückgegeben werden
oder negative Werte, wie unten angegeben:
- Positive Werte geben Standorte oberhalb von LMSL an,
einschließlich der Oberflächen oder des Grundes von hoch gelegenen Seen.
- Negative Werte geben Standorte an, die unter LMSL liegen, einschließlich
an der Wasseroberfläche oder am Meeresgrund zu finden.
- Resolution (Auflösung) gibt den Abstand zwischen dem Datenpunkt und dem
Höhenangaben in Metern.
|
|
Elevation API verwenden
| 1 |
Jetzt einrichten |
Beginnen Sie mit Ihre
Google Cloud-Projekt
und schließen Sie die Einrichtung ab.
befolgen Sie die Anleitung. |
| 2 |
Höhenanfrage ausprobieren |
Sobald Sie einen API-Schlüssel haben, können Sie die Elevation API direkt auf der
in Ihrem Browser. Siehe Beispielanfragen
im Startleitfaden.
|
| 3 |
Komplexere Anfrage erstellen |
Sobald Sie ein Projekt eingerichtet haben, versuchen Sie es mit einer Anfrage, die Standortdaten entlang eines
Pfad. Siehe Pfade angeben
.
|
| 4 |
Grundlagen von Antworten |
Untersuchen Sie die Antworten auf Höhendaten, um sich auf die Verwendung der Höhendaten für Ihre App vorzubereiten. Weitere Informationen finden Sie unter
Antworten für die Höhe
.
|
| 5 |
Höhendaten in die eigene App einbinden |
Sie können Höhendaten verwenden, um standortbasierte Apps zu optimieren, z. B. Apps für Sport.
oder für Umfragedaten.
|
Verfügbare Clientbibliotheken
Rufen Sie diese API in der Sprache
Ihrer Wahl über eine der folgenden Clientbibliotheken:
Java-, Python-, Go- und Node.js-Client für Google Maps
Dienste sind von der Community unterstützte Clientbibliotheken, die im Rahmen der
Apache 2.0-Lizenz.
Sie können sie von GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-31 (UTC)."],[[["\u003cp\u003eThe Elevation API provides elevation data for locations on Earth, enabling applications with elevation-sensitive features.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve elevation for single points or calculate elevation differences along paths, useful for activities like hiking or biking.\u003c/p\u003e\n"],["\u003cp\u003eThe API accepts latitude/longitude coordinates and returns elevation data in meters relative to local mean sea level, with resolution information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access the Elevation API through various client libraries (Java, Python, Go, Node.js) and integrate it into their applications.\u003c/p\u003e\n"],["\u003cp\u003eTo get started, set up a Google Cloud project, try sample requests, and explore the documentation for detailed usage instructions.\u003c/p\u003e\n"]]],[],null,["The Elevation API is a service that returns elevation data for\na location on the earth, or sampled elevation data along paths.\n\nWhy use the Elevation API\n\nWith the Elevation API, you can develop applications to support your\ncustomers with elevation-sensitive activities, positioning applications, or low-surveying\napplications that include elevations and elevation changes along routes. For example,\nyou can provide elevation gain and loss data to enhance a sports application for activities such\nas hiking, biking, or scuba diving.\n\nWhat you can do with the Elevation API\n\nWith the Elevation API, you can include elevation data in your\napplications or on a map. For example:\n\n- Get the **elevation** for a particular place.\n- Calculate the **differences** in elevation along a route or between two points.\n\nHow the Elevation API works The Elevation API accepts a request as an encoded URL with latitude/longitude coordinates provided as either discrete locations, or as a series of locations along a path. This request, for example, queries elevation for the center of Denver, Colorado, specifying a return in JSON format. \n\n```scdoc\n https://maps.googleapis.com/maps/api/elevation/json\n ?locations=39.7391536%2C-104.9847034\n &key=YOUR_API_KEY\n```\n\nThe service derives the elevation for the provided coordinates. It also interpolates\nelevation for a location without elevation, providing an average returned from the four\nnearest locations that do provide elevation data. Finally, it determines the overall\nresolution for the location.\n\nResources\n\nThe following table summarizes the resources available through the\nElevation API along with the data it returns.\n\n| Data resources | Data returned | Return format |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| **Latitude/longitude coordinates** You can provide data as a set of one or more locations, or as a series along a path. You can also provide encoded coordinates. Pass up to 512 coordinates. | The Elevation API provides **elevation in meters** relative to the **local mean sea level** (LMSL). Elevation can be returned as positive or negative values as indicated below: - **Positive values** indicate locations above LMSL, including surface locations or the bottom of high-altitude lakes. - **Negative values** indicate locations that are below LMSL, including locations on the surface or the ocean floor. - **Resolution** indicates the distance between the data point and the elevation, in meters. | - JSON - XML |\n\nHow to use the Elevation API\n\n|---|---------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/elevation/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try an elevation request** | Once you have an API key, you can start testing out the Elevation API directly from your browser. See [Sample requests](/maps/documentation/elevation/start#sample-request) in the *Getting started* guide for details. |\n| 3 | **Compose a more complex request** | Once you are set up with a project, try a request that supplies a location data along a path. See [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths) for details. |\n| 4 | **Understand response basics** | Explore the elevation data responses to prepare to use elevation data for your app. See [Elevation responses](/maps/documentation/elevation/requests-elevation#ElevationResponses) for details. |\n| 5 | **Incorporate elevation data into your own app!** | You can use elevation data to enhance location-based apps, such as apps for sports activities or for survey data. |\n\nAvailable client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n\n- **Start using the Elevation API** : Go to [Set up your\n Google Cloud project](/maps/documentation/elevation/cloud-setup).\n- **Try getting path-based elevation data** : Go to [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths)\n- **Follow best practices** : Go to [Web Service\n Best Practices](/maps/documentation/elevation/web-service-best-practices)."]]
