Recherche d'altitude

L'altitude en mètres au-dessus du niveau moyen de la mer, pour un ou plusieurs points.

Paramètres

L'endpoint accepte aussi POST avec un corps JSON {"locations": [[lat, lon], ...]} pour les longues listes qui ne tiendraient pas dans une URL.

Exemple

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/elevation?locations=36.2381,-116.8175|31.5590,35.4732"

const points = [[36.2381, -116.8175], [31.5590, 35.4732]];
const url = new URL("https://api.mygeocode.com/v1/elevation");
url.searchParams.set("locations", points.map((p) => p.join(",")).join("|"));

const { results } = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
results.forEach((r) => console.log(r.elevation_m));

import requests

points = [(36.2381, -116.8175), (31.5590, 35.4732)]
locations = "|".join(f"{lat},{lon}" for lat, lon in points)
r = requests.get("https://api.mygeocode.com/v1/elevation", params={"locations": locations}, headers={"X-API-Key": "YOUR_KEY"}, timeout=10)
for item in r.json()["results"]:
    print(item["elevation_m"])

{
  "status": "ok",
  "results": [
    { "lat": 36.2381, "lon": -116.8175, "elevation_m": -82.0, "resolution_m": 463.8 },
    { "lat": 31.559, "lon": 35.4732, "elevation_m": -416.0, "resolution_m": 463.8 }
  ]
}

Champs de la réponse

Remarques

• Les valeurs proviennent de la cellule la plus proche d'une grille de 15 secondes d'arc (environ 460 m), mondiale, terres et fonds marins. Attendez-vous à la hauteur du terrain environnant plutôt qu'à une cote ponctuelle : suffisant pour les profils, les bassins versants, les liaisons radio et les contrôles de cohérence, trop grossier pour un bâtiment isolé ou une crête étroite. La précision verticale est généralement de quelques mètres sur un relief doux et de plusieurs dizaines de mètres en montagne escarpée.
• Sur les plans d'eau intérieurs (lacs, réservoirs), la valeur est l'altitude de la surface.
• L'altitude ne change pas. Mettez les résultats en cache aussi longtemps que vous le souhaitez.
• Les formats de requête Google Elevation, Bing Elevations et Open-Elevation sont disponibles sur les hôtes compatibles.

La même recherche aux formats d'autres fournisseurs

Si vous avez déjà du code écrit pour l'un de ces fournisseurs, gardez-le : l'hôte compatible accepte le même chemin et les mêmes paramètres et répond dans le format de réponse de ce fournisseur, avec cet endpoint derrière. Voir le fonctionnement des hôtes compatibles.

Erreurs

400 invalid_request lorsque ni un point ni locations n'est fourni, lorsqu'une coordonnée est hors limites ou mal formée, lorsqu'il y a plus de 100 points, ou lorsque samples, rows ou cols produiraient plus de 100 points. 503 backend_unavailable lorsque le service d'altitude ne répond pas ; rien n'est compté.