Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Elevation est un service qui renvoie des données d'altitude pour
un point géographique sur Terre ou des données d'altitude échantillonnées le long d'un tracé.
Pourquoi utiliser l'API Elevation ?
Avec l'API Elevation, vous pouvez développer des applications compatibles avec vos
les clients ayant des activités sensibles à l'altitude, des applications de positionnement ou ayant peu d'arpentage ;
applications qui incluent le dénivelé et les dénivelés le long d'un itinéraire. Par exemple :
vous pouvez fournir des données de dénivelé et de perte d'altitude afin d'améliorer une application sportive pour des activités telles que
comme la randonnée, le vélo
ou la plongée sous-marine.
Ce que vous pouvez faire avec l'API Elevation
Avec l'API Elevation, vous pouvez inclure des données d'altitude dans vos
applications ou sur une carte. Exemple :
Obtenez l'altitude d'un lieu spécifique.
Calculer les différences d'altitude le long d'un itinéraire ou entre deux
points.
Fonctionnement de l'API Elevation
L'API Elevation accepte une requête sous forme d'URL encodée avec des coordonnées de latitude/longitude.
fournis sous la forme d'emplacements distincts ou d'une série d'emplacements sur un chemin. Cette demande,
Par exemple, la requête permet de rechercher l'altitude pour le centre de Denver, dans le Colorado, en spécifiant un retour au format JSON.
Le service détermine l'altitude pour les coordonnées fournies. Elle interpole également
d'un lieu sans altitude, ce qui fournit une moyenne renvoyée par les quatre
les lieux les plus proches qui
fournissent des données d’altitude. Enfin, elle détermine l'état
pour le lieu en question.
Ressources
Le tableau suivant récapitule les ressources disponibles via le
API Elevation avec les données qu'elle renvoie.
Ressources de données
Données renvoyées
Format de retour
Coordonnées (latitude/longitude)
Vous pouvez fournir les données sous la forme d'un ensemble d'un ou de plusieurs points géographiques, ou d'une série sur un tracé. Toi
peut également fournir des coordonnées encodées. Transmettez jusqu'à 512 coordonnées.
L'API Elevation fournit l'élévation en mètres,
au niveau de la mer moyen local (LMSL). L'élévation peut être renvoyée en tant que valeur positive
négatives ou négatives, comme indiqué ci-dessous:
Les valeurs positives indiquent les zones géographiques au-dessus du LMSL.
comme les emplacements en surface ou le fond de lacs de haute altitude.
Les valeurs négatives indiquent les zones géographiques situées en dessous du LMSL, y compris
à la surface ou dans le fond océanique.
La résolution indique la distance entre le point de données et le
en mètres.
Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Elevation directement
votre navigateur. Consultez la section Exemples de requêtes.
dans le guide de démarrage.
Explorez les réponses liées aux données d'altitude pour vous préparer à les utiliser pour votre application. Voir
Réponses d'altitude
pour en savoir plus.
5
Intégrez des données d'altitude à votre propre application.
Vous pouvez utiliser les données d'altitude pour améliorer les applications basées sur la localisation, comme les applications de sport.
les activités ou pour
les données d'enquête.
Bibliothèques clientes disponibles
Appelez cette API dans le langage de
de votre choix via l'une des bibliothèques clientes suivantes:
Les clients Java, Python, Go et Node.js pour Google Maps
Les services sont des bibliothèques clientes soutenues par la communauté, disponibles en Open Source dans le cadre du
Licence Apache 2.0
Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
