Présentation de l'API Elevation

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:

  • Les valeurs positives indiquent les lieux au-dessus du LMSL, y compris les emplacements en surface ou le fond des lacs de haute altitude.
  • Les valeurs négatives correspondent aux positions en dessous du LMSL, y compris celles situées à la surface ou au fond de l'océan.
  • Résolution : indique la distance en mètres entre le point de données et l'altitude.
  • JSON
  • XML

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:

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