AtlasDéveloppeurs
Référence

Erreurs

Toute erreur renvoie un statut HTTP et un objet error dont le code est stable : basez votre logique dessus, pas sur le message, rédigé en anglais et susceptible d’évoluer.

Réponse · 401
{
  "error": {
    "code": "unauthorized",
    "message": "Send your API key in the Authorization: Bearer header.",
    "request_id": "c6e645e4-5d82-484f-bab3-c52a2acae23d"
  }
}
Réponse réelle d’un appel sans clé. request_id figure aussi dans l’en-tête X-Request-Id.

Codes

HTTPCodeCauseQue faire
400invalid_queryq contient moins de 3 ou plus de 100 caractères recherchables.Attendez au moins trois caractères avant d’appeler l’API.
400invalid_limitlimit n’est pas un entier entre 1 et 20.Corrigez la valeur ou omettez le paramètre.
400invalid_parameterParamètre inconnu, répété, ou chaîne de requête trop longue.N’envoyez que les paramètres documentés, une seule fois chacun.
400invalid_coordinatesCoordonnées absentes ou mal formées.Envoyez longitude,latitude en degrés décimaux, dans cet ordre.
400outside_coverageLe point est hors de la zone couverte.Longitude 7,4 à 11,7 et latitude 30,2 à 37,7. Vérifiez l’ordre longitude, latitude.
400invalid_radiusradius n’est pas compris entre 1 et 5 000 mètres.Corrigez la valeur ou omettez le paramètre.
400invalid_routeDépart et arrivée sont à moins de 10 mètres l’un de l’autre.Éloignez les points ou n’appelez pas l’API pour ce trajet.
401unauthorizedClé absente, mal formée, expirée ou révoquée.Envoyez Authorization: Bearer atlas_maps_… ; créez ou renouvelez la clé dans la console.
403insufficient_scopeLa clé ne donne pas accès à ce point d’accès.Utilisez une clé « Lieux et itinéraires » ou la portée correspondante.
404not_foundPoint d’accès inconnu.Points d’accès disponibles : places, reverse, directions.
405method_not_allowedSeule la méthode GET est acceptée.Envoyez une requête GET.
429rate_limit_exceededQuota par minute ou par jour atteint.Attendez la durée indiquée par l’en-tête Retry-After, en secondes, avant de réessayer.
503routing_unavailableLe moteur de routage n’a pas répondu ou a renvoyé un trajet invalide.Réessayez après Retry-After (10 s). Aucun tracé estimé n’est fourni.
503service_unavailableIncident inattendu côté Atlas.Réessayez après Retry-After (10 s) et communiquez request_id au support si l’erreur persiste.

Réessayer ou non

Réessayez uniquement les réponses 429 et 503, après le délai de l’en-tête Retry-After. Les erreurs 4xx ne changeront pas en réessayant : corrigez la requête.