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 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 pour répondre aux besoins de vos clients avec des activités sensibles à l'altitude, des applications de positionnement ou des applications de basse arpentage qui incluent des élévations et des changements d'altitude 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 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.
  • 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 sous la forme d'une URL encodée avec des coordonnées de latitude/longitude fournies sous forme de points géographiques distincts ou de série de points géographiques le long d'un tracé. Cette requête, par exemple, interroge l'altitude pour le centre de Denver, dans le 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 pour un point géographique sans altitude, ce qui fournit une moyenne renvoyée par les quatre lieux les plus proches qui fournissent des données d'altitude. Enfin, il détermine la résolution globale du lieu.

Ressources

Le tableau suivant récapitule les ressources disponibles via l'API Elevation, ainsi que les données qu'elle renvoie.

Ressources de données Données renvoyées Format renvoyé
Coordonnées (latitude/longitude)

Vous pouvez fournir des données sous la forme d'un ensemble d'un ou de plusieurs lieux, ou d'une série le long d'un tracé. Vous pouvez également fournir des coordonnées encodées. Transmettez jusqu'à 512 coordonnées.

L'API Elevation fournit l'altitude en mètres par rapport au niveau de la mer moyen 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 emplacements situés au-dessus du LMSL, y compris les emplacements en surface ou le fond des lacs de haute altitude.
  • Les valeurs négatives indiquent les zones géographiques inférieures au LMSL, y compris les emplacements à la surface ou dans les fonds océaniques.
  • Resolution (Résolution) indique la distance entre le point de données et l'altitude, en mètres.
  • JSON
  • XML

Utiliser l'API Elevation

1 Configuration Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration.
2 Envoyer une demande 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 les exemples de requêtes du guide de démarrage.
3 Saisir une requête plus complexe Une fois votre projet configuré, exécutez une requête qui fournit des données de localisation le long d'un chemin d'accès. Pour plus d'informations, consultez la section Spécifier des chemins d'accès .
4 Comprendre les principes de base des réponses Explorez les réponses des données d'altitude afin de vous préparer à utiliser ces données pour votre application. Pour en savoir plus, consultez la section Réponses d'altitude.
5 Intégrez des données d'altitude dans votre propre application. Vous pouvez utiliser les données d'altitude pour améliorer les applications basées sur la position, telles que les applications d'activités sportives ou de données d'enquête.

Bibliothèques clientes disponibles

Appelez cette API dans le langage de votre choix via l'une des bibliothèques clientes suivantes:

Les clients Java, Python, Go et Node.js pour les services Google Maps sont des bibliothèques clientes alimentées par la communauté, disponibles en Open Source sous la licence Apache 2.0. Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étapes suivantes