AtlasDéveloppeurs
Point d’accès

Rechercher un lieu

Recherche textuelle dans les lieux, localités, rues et adresses du catalogue Atlas.

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

Chaque mot de la requête doit se retrouver dans le nom ou le contexte d’un résultat. Les accents, la casse et la ponctuation sont ignorés ; les noms des principales villes sont reconnus en français et en arabe (La Marsa / المرسى, Sousse / سوسة…).

Si aucun résultat exact n’existe, une seule faute de frappe est tolérée sur un mot de quatre lettres ou plus ; la réponse l’indique avec search_strategy = approximate_fallback.

Une réponse vide (data: []) est un résultat valide : HTTP 200.

Paramètres

qstringobligatoire

Nom de lieu, de rue, d’adresse ou de localité.

3 à 100 caractères recherchables

limitintegerfacultatif

Nombre maximal de résultats.

1 à 20, 10 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. 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).

match_qualitystring

exact_name, name_prefix, terms ou approximate : comment le résultat correspond à la requête.

Champs de meta

search_strategystring

normalized_tokens, ou approximate_fallback.

match_typestring

Toujours catalogue_search.

Erreurs

HTTPCodeCause
400invalid_queryq contient moins de 3 ou plus de 100 caractères recherchables.
400invalid_limitlimit n’est pas un entier entre 1 et 20.
400invalid_parameterParamètre inconnu, répété, ou chaîne de requête trop longue.
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/places' \
  -H "Authorization: Bearer $ATLAS_MAPS_KEY" \
  -H 'User-Agent: MonApp/1.0' \
  --data-urlencode 'q=La Marsa' \
  --data-urlencode 'limit=3'
Réponse · 200
{
  "data": [
    {
      "id": "n287547219",
      "name": "La Marsa",
      "alternate_name": null,
      "context": "المرسى",
      "kind": "locality",
      "category": "locality",
      "coordinates": [
        10.327678,
        36.879088
      ],
      "match_quality": "exact_name"
    },
    {
      "id": "n2677320377",
      "name": "Al-Marsa",
      "alternate_name": "المرسى",
      "context": "Médenine",
      "kind": "poi",
      "category": "place",
      "coordinates": [
        10.734695,
        33.695759
      ],
      "match_quality": "exact_name"
    },
    {
      "id": "a197240646",
      "name": "La Marsa",
      "alternate_name": "المرسى",
      "context": "2070 المرسى",
      "kind": "poi",
      "category": "place",
      "coordinates": [
        10.31909,
        36.884135
      ],
      "match_quality": "exact_name"
    }
  ],
  "meta": {
    "request_id": "00000000-0000-4000-8000-000000000000",
    "attribution": "© OpenStreetMap contributors · Catalogue Atlas",
    "catalogue_updated_at": "2026-09-02T12:27:42.728Z",
    "match_type": "catalogue_search",
    "exact_address_guaranteed": false,
    "search_strategy": "normalized_tokens"
  }
}
Réponse réelle pour q=La Marsa&limit=3 sur le catalogue du 2 septembre 2026.
Essayer cette requête