AtlasDéveloppeurs
Point d’accès

Calculer un itinéraire

Trajet routier en voiture entre deux points : distance, durée et tracé.

GET/api/maps/v1/directionsBêta
Dépend du moteur de routage Atlas, hébergé à part. En cas d’indisponibilité : 503 routing_unavailable.

Le 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

startstringobligatoire

Point de départ, au format longitude,latitude.

Dans la zone couverte (Tunisie)

endstringobligatoire

Point 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.

profilestring

Toujours car.

distance_mnumber

Longueur du trajet en mètres.

duration_snumber

Durée estimée en secondes, hors trafic.

geometryGeoJSON LineString

Tracé du trajet : liste de positions [longitude, latitude], 50 000 au plus.

trafficstring

Toujours not_included.

Erreurs

HTTPCodeCause
400invalid_parameterParamètre inconnu, répété, ou chaîne de requête trop longue.
400invalid_coordinatesCoordonnées absentes ou mal formées.
400outside_coverageLe point est hors de la zone couverte.
400invalid_routeDépart et arrivée sont à moins de 10 mètres l’un de l’autre.
401unauthorizedClé absente, mal formée, expirée ou révoquée.
403insufficient_scopeLa clé ne donne pas accès à ce point d’accès.
429rate_limit_exceededQuota par minute ou par jour atteint.
503routing_unavailableLe 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'
Structure de la réponse · 200
{
  "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"
  }
}
Essayer cette requête