Commencer

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 points de profondeur dans le fond océanique (qui renvoient des valeurs négatives).

Ce service est également disponible avec l'API Maps JavaScript côté client ou avec 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 la forme d'une chaîne d'URL, en utilisant des coordonnées de latitude/longitude pour identifier des points géographiques ou des sommets de tracé. Les requêtes doivent inclure votre clé d'API.

L'exemple suivant demande l'altitude de Denver, au 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'

Effectuez un test en saisissant 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 la 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 savoir comment créer des URL de requête et les 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 facilitent le développement avec les API de services Web Google Maps en fournissant des implémentations simples et natives 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 définis pour l'API Elevation.

Règles

L'API Elevation doit être utilisée conformément aux Règles des API.

En savoir plus

L'API Elevation vous permet d'effectuer d'autres opérations, comme demander des données d'altitude à partir de plusieurs lieux. Consultez le guide du développeur de l'API Elevation pour obtenir plus d'exemples et d'autres détails.

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