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
| HTTP | Code | Cause | Que faire |
|---|---|---|---|
| 400 | invalid_query | q contient moins de 3 ou plus de 100 caractères recherchables. | Attendez au moins trois caractères avant d’appeler l’API. |
| 400 | invalid_limit | limit n’est pas un entier entre 1 et 20. | Corrigez la valeur ou omettez le paramètre. |
| 400 | invalid_parameter | Paramè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. |
| 400 | invalid_coordinates | Coordonnées absentes ou mal formées. | Envoyez longitude,latitude en degrés décimaux, dans cet ordre. |
| 400 | outside_coverage | Le point est hors de la zone couverte. | Longitude 7,4 à 11,7 et latitude 30,2 à 37,7. Vérifiez l’ordre longitude, latitude. |
| 400 | invalid_radius | radius n’est pas compris entre 1 et 5 000 mètres. | Corrigez la valeur ou omettez le paramètre. |
| 400 | invalid_route | Dé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. |
| 401 | unauthorized | Clé absente, mal formée, expirée ou révoquée. | Envoyez Authorization: Bearer atlas_maps_… ; créez ou renouvelez la clé dans la console. |
| 403 | insufficient_scope | La clé ne donne pas accès à ce point d’accès. | Utilisez une clé « Lieux et itinéraires » ou la portée correspondante. |
| 404 | not_found | Point d’accès inconnu. | Points d’accès disponibles : places, reverse, directions. |
| 405 | method_not_allowed | Seule la méthode GET est acceptée. | Envoyez une requête GET. |
| 429 | rate_limit_exceeded | Quota 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. |
| 503 | routing_unavailable | Le 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. |
| 503 | service_unavailable | Incident 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.