Commencer

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

Exemple de requête et de réponse

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

L'exemple suivant demande l'altitude de Denver (Colorado), la "ville à mille pieds d'altitude", au format JSON:

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

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

Pour le tester, saisissez l'URL dans votre navigateur Web (assurez-vous de 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 (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 la création d'URL de requête et des paramètres disponibles, ainsi que sur la compréhension de la réponse.

Vous trouverez ci-dessous un exemple de réponse:

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

<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 service Web Google Maps en fournissant des implémentations natives simples de tâches courantes, telles que l'authentification, le débit limité 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 la section 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'utilisation de l'API Elevation doit être conforme aux Règles de l'API.

En savoir plus

Vous pouvez faire d'autres choses avec l'API Elevation, comme demander des données d'altitude à partir de plusieurs emplacements. Pour en savoir plus et obtenir d'autres exemples, consultez le guide du développeur de l'API Elevation.

Le guide du développeur de l'API Elevation s'adresse 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.