Un point ou plusieurs
Les altitudes sont en mètres. Un lot accepte jusqu'à 10 000 points et compte pour une requête.
Profil altimétrique d'un itinéraire
POST /v1/route/profile prend un itinéraire GeoJSON et l'échantillonne tous les stepM mètres (de 10 à 1 000 ; par défaut environ 2 000 échantillons). Le dénivelé positif total est calculé après lissage des altitudes sur environ 100 m, pour que le bruit d'un modèle de terrain ne s'additionne pas en un dénivelé qui n'existe pas. Sur les ponts et dans les tunnels, les altitudes suivent la route, pas la vallée en dessous ni la montagne au-dessus, et la réponse liste ces tronçons ; avec "heights": "terrain", on obtient le sol sous chaque point. Un profil compte au plus 5 000 points d'échantillonnage : sur les longs itinéraires, le pas devient plus grand que celui demandé. Pour une trace enregistrée, "at": "points" donne plutôt une altitude à chacun de ses propres points, jusqu'à 50 000, et garde les distances de la trace. Chaque pont et chaque tunnel est accompagné de sa hauteur libre quand OpenStreetMap la connaît, et POST /v1/route/surfaces liste toutes les limites de hauteur le long d'une trace, passages sous les ponts compris.
{
"routeLengthKm": 86.311, "stepM": 500,
"ascentM": 1020, "descentM": 358, "minM": 374.5, "maxM": 1109.4,
"profile": [
{ "km": 0, "lon": 6.143006, "lat": 46.204, "ele": 375.1 },
{ "km": 0.5, "lon": 6.148751, "lat": 46.202742, "ele": 374.5 },
...
]
}Voici une sortie à vélo de route de Genève à Chamonix. Le profil est aussi fourni avec POST /v1/route/report, avec la météo le long de l'itinéraire et les fuseaux horaires traversés.
Une grille sur une zone
GET /v1/area?bbox=west,south,east,north&include=elevation&cells=400 renvoie l'altitude au centre de chaque cellule d'une grille de 400 cellules au maximum, ligne par ligne à partir du coin nord-ouest, sur la même grille que la météo et la qualité de l'air de cette zone.
{ "rows": 2, "cols": 2, "lon": [6.8375, 6.9125], "lat": [45.9625, 45.8875],
"elevation": { "values": [2145.8, 1237.3, 1426.5, 3257.8] } }Tuiles de relief
Les tuiles pour l'ombrage du relief et le terrain 3D se trouvent à /v1/dem/{z}/{x}/{y}.png (256 px, encodage Terrarium, zoom 0 à 13) et .webp (512 px, zoom 0 à 12). Elles se chargent comme de simples images dans MapLibre et les bibliothèques similaires, sous n'importe quel style de fond de carte : les tuiles de fond de carte, les styles et les polices ne font pas partie de l'API. Chaque tranche de 50 tuiles compte pour une requête, et les tuiles n'occupent pas l'un de vos emplacements simultanés.
Tarifs
L'offre gratuite donne 500 requêtes par jour, y compris pour les applications commerciales ; Developer coûte 14,99 $ par mois pour 5 000 requêtes par jour. Données cartographiques, météo, qualité de l'air, niveaux des rivières et routage sont sur la même clé.
Crédits : relief de Mapterhorn.