AtlasDéveloppeurs
Point d’accès

Lieu le plus proche

Géocodage inverse : l’élément du catalogue le plus proche d’un point, dans un rayon donné.

GET/api/maps/v1/reverseDisponible
Servi par le catalogue Atlas embarqué dans l’API.

Renvoie 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

pointstringobligatoire

Position à rechercher, au format longitude,latitude.

Dans la zone couverte (Tunisie)

radiusnumberfacultatif

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

idstring

Identifiant stable de l’objet dans la source (OpenStreetMap / Atlas).

namestring

Nom tel qu’il figure dans la source, sans réécriture.

alternate_namestring | null

Second nom, le plus souvent en arabe, ou null.

contextstring

Contexte de la source : quartier, gouvernorat ou adresse. Peut être vide.

kindstring

poi, locality, street ou address.

categorystring

Type 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_minteger

Distance à vol d’oiseau entre le point et le résultat.

Champs de meta

match_typestring

Toujours nearest_catalogue_feature.

exact_address_guaranteedboolean

Toujours false.

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_radiusradius n’est pas compris entre 1 et 5 000 mètres.
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.

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'
Réponse · 200
{
  "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
  }
}
Réponse réelle pour point=10.1815,36.8065&radius=1000 sur le catalogue du 2 septembre 2026.
Essayer cette requête