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 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. 
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

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.
  • JSON
  • XML

Utiliser l'API Elevation

1 Configuration Commencez par Configurer votre Projet Google Cloud et terminez la configuration en suivant les instructions ci-dessous.
2 Essayer une requête d'élévation 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.
3 Rédiger une requête plus complexe Une fois votre projet configuré, essayez une requête qui fournit des données de localisation chemin d'accès. Reportez-vous à la section Spécifier des chemins d'accès. pour en savoir plus.
4 Comprendre les principes de base des réponses 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.

Étape suivante