Premiers pas

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

Ce service est également disponible dans l'API Maps JavaScript côté client, ou pour une utilisation côté serveur avec les clients Java, 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 sous forme de 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 de Denver, Colorado, la "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'

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

Pour en savoir plus sur la création d'URL de requête et les paramètres disponibles, ainsi que sur l'interprétation de la réponse, consultez le guide du développeur.

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>
</pre>

Commencer à coder avec nos bibliothèques clients

Les bibliothèques clientes facilitent le développement avec les API de service Web Google Maps en fournissant des implémentations intégrées de tâches courantes, telles que l'authentification, la limitation des requêtes et les nouvelles tentatives automatiques. L'API Elevation est disponible dans les clients Java, 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 identifiants d'authentification appropriés. Pour en savoir plus, consultez Premiers pas avec Google Maps Platform.

Quotas et tarifs

Consultez la page Utilisation et facturation pour en savoir plus sur les quotas et les tarifs de 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 permet d'effectuer d'autres actions, comme demander des données d'altitude pour plusieurs emplacements. Pour obtenir d'autres exemples et plus d'informations, consultez le guide du développeur de l'API Elevation.

Le guide du développeur de l'API Elevation est destiné aux développeurs de sites Web et d'applications mobiles qui souhaitent utiliser des données d'altitude dans les cartes fournies par l'une des API Google Maps Platform. Il fournit une introduction à l'utilisation de l'API et des documents de référence sur les paramètres disponibles.