Lieu le plus proche
Géocodage inverse : l’élément du catalogue le plus proche d’un point, dans un rayon donné.
/api/maps/v1/reverseDisponibleRenvoie au plus un résultat : le lieu, la rue, l’adresse ou la localité recensé le plus proche du point, avec sa distance en mètres. Si rien n’est recensé dans le rayon, data est vide.
Le résultat est une référence de proximité, pas une adresse postale garantie : meta.exact_address_guaranteed vaut toujours false.
Paramètres
pointstringobligatoirePosition à rechercher, au format longitude,latitude.
Dans la zone couverte (Tunisie)
radiusnumberfacultatifRayon de recherche en mètres.
1 à 5 000, 1 000 par défaut
Tout autre paramètre, ou un paramètre répété, est refusé avec invalid_parameter.
Réponse
data est une liste de 0 ou 1 élément. meta contient request_id, à communiquer au support, et attribution, à afficher avec les résultats.
idstringIdentifiant stable de l’objet dans la source (OpenStreetMap / Atlas).
namestringNom tel qu’il figure dans la source, sans réécriture.
alternate_namestring | nullSecond nom, le plus souvent en arabe, ou null.
contextstringContexte de la source : quartier, gouvernorat ou adresse. Peut être vide.
kindstringpoi, locality, street ou address.
categorystringType précis du lieu (cafe, pharmacy, school…). Pour une rue, une adresse ou une localité, reprend kind.
coordinates[number, number]Longitude, latitude (WGS 84).
distance_mintegerDistance à vol d’oiseau entre le point et le résultat.
Champs de meta
match_typestringToujours nearest_catalogue_feature.
exact_address_guaranteedbooleanToujours false.
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_radius | radius n’est pas compris entre 1 et 5 000 mètres. |
| 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. |
Que faire pour chaque code : Erreurs. Quotas : Limites et quotas.
curl --get 'https://atlastunisie.com/api/maps/v1/reverse' \ -H "Authorization: Bearer $ATLAS_MAPS_KEY" \ -H 'User-Agent: MonApp/1.0' \ --data-urlencode 'point=10.1815,36.8065' \ --data-urlencode 'radius=1000'
{
"data": [
{
"id": "n2157231106",
"name": "MG Maxi",
"alternate_name": null,
"context": "Avenue du Ghana, 1001 تونس",
"kind": "poi",
"category": "supermarket",
"coordinates": [
10.181558,
36.806353
],
"distance_m": 17
}
],
"meta": {
"request_id": "00000000-0000-4000-8000-000000000000",
"attribution": "© OpenStreetMap contributors · Catalogue Atlas",
"catalogue_updated_at": "2026-09-02T12:27:42.728Z",
"match_type": "nearest_catalogue_feature",
"exact_address_guaranteed": false
}
}point=10.1815,36.8065&radius=1000 sur le catalogue du 2 septembre 2026.