
L'API Elevation est un service qui renvoie des données d'altitude pour un point géographique sur la 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 qui aident vos clients à effectuer des activités sensibles à l'altitude, des applications de positionnement ou des applications à faible arpentage incluant les altitudes et les changements d'altitude le long d'un itinéraire. Par exemple, vous pouvez fournir des données sur le dénivelé et l'altitude pour améliorer une application sportive destinée à des activités telles que la randonnée, le vélo ou la plongée.
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.
- Calculez 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 en tant qu'URL encodée avec des coordonnées de latitude/longitude fournies en tant que lieux distincts ou en tant que série de points le long d'un chemin. Par exemple, cette requête interroge l'altitude pour le centre de Denver, au Colorado, en spécifiant un retour au format JSON.https://maps.googleapis.com/maps/api/elevation/json ?locations=39.7391536%2C-104.9847034 &key=YOUR_API_KEY
Le service obtient l'altitude pour les coordonnées fournies. Elle interpole également l'altitude d'un lieu sans altitude. Elle fournit une moyenne renvoyée par les quatre lieux les plus proches fournissant des données d'altitude. Enfin, il détermine la résolution globale de l'établissement.
Ressources
Le tableau suivant récapitule les ressources disponibles via l'API Elevation ainsi que les données renvoyées.
Ressources de données | Données renvoyées | Format de retour |
---|---|---|
Coordonnées (latitude/longitude)
Vous pouvez fournir des données sous la forme d'un ensemble d'un ou de plusieurs emplacements, ou sous forme de série le long d'un chemin. Vous pouvez également fournir des coordonnées encodées. Transmettez jusqu'à 512 coordonnées. |
L'API Elevation fournit une altitude en mètres par rapport au niveau moyen de la mer local (LMSL). L'altitude peut être renvoyée sous forme de valeurs positives ou négatives, comme indiqué ci-dessous:
|
|
Utiliser l'API Elevation
1 | Configurer | Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration qui suivent. |
2 | Essayer une requête d'altitude | Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Elevation directement dans votre navigateur. Pour en savoir plus, consultez Exemples de requêtes dans le guide de démarrage. |
3 | Rédiger une requête plus complexe | Une fois que vous avez configuré un projet, essayez une requête qui fournit des données de localisation le long d'un chemin. Pour en savoir plus, consultez la section Spécifier des chemins d'accès . |
4 | Comprendre les principes de base des réponses | Explorez les réponses aux données d'altitude pour vous préparer à utiliser les données d'altitude pour votre application. Pour en savoir plus, consultez Réponses à l'altitude. |
5 | Intégrez les données d'altitude dans votre propre application. | Vous pouvez utiliser les données d'altitude pour améliorer les applications géolocalisées, telles que les applications de sports ou d'enquête. |
Bibliothèques clientes disponibles
Appelez cette API dans le langage de votre choix via l'une des bibliothèques clientes suivantes:
- Client Java pour les services Google Maps
- Client Python pour les services Google Maps
- Client Go pour les services Google Maps
- Client Node.js pour les services Google Maps
Le client Java, le client Python, le client Go et le client Node.js pour les services Google Maps sont des bibliothèques clientes compatibles avec la communauté, disponibles en Open Source sous la licence Apache 2.0. Téléchargez-les sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.
Étapes suivantes
- Pour commencer à utiliser l'API Elevation, consultez la page Configurer votre projet Google Cloud.
- Essayez d'obtenir des données d'altitude basées sur le tracé: consultez la section Spécifier des tracés.
- Suivez les bonnes pratiques: consultez Bonnes pratiques concernant les services Web.