Commencer

L'API Elevation fournit des données d'altitude pour tous les points géographiques du la surface de la Terre, y compris les fonds océaniques (qui renvoient des valeurs négatives).

Ce service est également disponible dans le cadre API Maps JavaScript ou pour une utilisation côté serveur Client Java, les clients Python, Go et Node.js pour les services Google Maps.

Exemple de requête et de réponse

Vous accédez à l'API Elevation via une interface HTTP, avec des requêtes construites comme une chaîne d'URL, en utilisant des coordonnées de latitude/longitude pour identifier les emplacements ou les sommets du chemin. Les requêtes doivent inclure votre clé d'API.

L'exemple suivant demande l'altitude pour Denver, Colorado, "Mile High City", au format JSON:

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

Pour ce faire, saisissez l'URL dans votre navigateur Web (veillez à remplacer YOUR_API_KEY par votre clé API réelle). La réponse inclut l'altitude à ce point, en mètres, ainsi que la valeur de résolution (la distance maximale entre les points de données à partir desquels l'altitude a été interpolée (en mètres).

Consultez le guide du développeur. pour en savoir plus sur <ph type="x-smartling-placeholder"></ph> création d'URL de demande et de paramètres disponibles et comprendre la réponse.

Voici un exemple de réponse:

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

Commencer à coder avec nos bibliothèques clients

Les bibliothèques clientes permettent le développement avec les API de services Web Google Maps en fournissant des des implémentations natives des tâches courantes, telles que l'authentification, la limitation et les nouvelles tentatives automatiques. L'API Elevation est disponible dans Client Java, les clients Python, Go et Node.js pour les services Google Maps.

Authentification, quotas, tarifs et règles

Authentification

Pour utiliser l'API Elevation, vous devez d'abord l'activer et obtenir les d'authentification unique. Pour en savoir plus, consultez Premiers pas avec Google Maps Platform

Quotas et tarifs

Examiner l'utilisation et la facturation pour en savoir plus sur les quotas et les tarifs définis pour l'API Elevation.

Règles

L'utilisation de l'API Elevation doit être conforme aux Règles de l'API

En savoir plus

L'API Elevation vous offre d'autres possibilités, comme demander des données d'altitude à partir de plusieurs emplacements. Consultez les le guide du développeur de l'API Elevation pour en savoir plus des exemples et d'autres détails.

Le le guide du développeur de l'API Elevation est destiné aux sites Web et Les développeurs d'applications mobiles qui souhaitent utiliser des données d'altitude dans des cartes fournies par l'un des API Google Maps Platform. Il présente l'utilisation de l'API et fournit sur les paramètres disponibles.