Calculer un itinéraire
Trajet routier en voiture entre deux points : distance, durée et tracé.
/api/maps/v1/directionsBêtaLe calcul est fait par le moteur de routage Atlas (Valhalla, profil voiture adapté à la Tunisie). Le trafic n’est pas pris en compte : traffic vaut toujours not_included.
Si le moteur ne répond pas, l’API renvoie 503 routing_unavailable. Aucun tracé à vol d’oiseau n’est jamais substitué.
Paramètres
startstringobligatoirePoint de départ, au format longitude,latitude.
Dans la zone couverte (Tunisie)
endstringobligatoirePoint d’arrivée, au format longitude,latitude.
Au moins 10 m du départ
Tout autre paramètre, ou un paramètre répété, est refusé avec invalid_parameter.
Réponse
data est un objet trajet. meta contient request_id, à communiquer au support, et attribution, à afficher avec les résultats.
profilestringToujours car.
distance_mnumberLongueur du trajet en mètres.
duration_snumberDurée estimée en secondes, hors trafic.
geometryGeoJSON LineStringTracé du trajet : liste de positions [longitude, latitude], 50 000 au plus.
trafficstringToujours not_included.
Erreurs
| HTTP | Code | Cause |
|---|---|---|
| 400 | invalid_parameter | Paramètre inconnu, répété, ou chaîne de requête trop longue. |
| 400 | invalid_coordinates | Coordonnées absentes ou mal formées. |
| 400 | outside_coverage | Le point est hors de la zone couverte. |
| 400 | invalid_route | Départ et arrivée sont à moins de 10 mètres l’un de l’autre. |
| 401 | unauthorized | Clé absente, mal formée, expirée ou révoquée. |
| 403 | insufficient_scope | La clé ne donne pas accès à ce point d’accès. |
| 429 | rate_limit_exceeded | Quota par minute ou par jour atteint. |
| 503 | routing_unavailable | Le moteur de routage n’a pas répondu ou a renvoyé un trajet invalide. |
Que faire pour chaque code : Erreurs. Quotas : Limites et quotas.
curl --get 'https://atlastunisie.com/api/maps/v1/directions' \ -H "Authorization: Bearer $ATLAS_MAPS_KEY" \ -H 'User-Agent: MonApp/1.0' \ --data-urlencode 'start=10.1815,36.8065' \ --data-urlencode 'end=10.3253,36.8782'
{
"data": {
"profile": "car",
"distance_m": <nombre>,
"duration_s": <nombre>,
"geometry": {
"type": "LineString",
"coordinates": [[<longitude>, <latitude>], …]
},
"traffic": "not_included"
},
"meta": {
"request_id": "<identifiant>",
"attribution": "© OpenStreetMap contributors · Catalogue Atlas"
}
}