Rechercher un lieu
Recherche textuelle dans les lieux, localités, rues et adresses du catalogue Atlas.
/api/maps/v1/placesDisponibleChaque 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
qstringobligatoireNom de lieu, de rue, d’adresse ou de localité.
3 à 100 caractères recherchables
limitintegerfacultatifNombre 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.
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).
match_qualitystringexact_name, name_prefix, terms ou approximate : comment le résultat correspond à la requête.
Champs de meta
search_strategystringnormalized_tokens, ou approximate_fallback.
match_typestringToujours catalogue_search.
Erreurs
| HTTP | Code | Cause |
|---|---|---|
| 400 | invalid_query | q contient moins de 3 ou plus de 100 caractères recherchables. |
| 400 | invalid_limit | limit n’est pas un entier entre 1 et 20. |
| 400 | invalid_parameter | Paramètre inconnu, répété, ou chaîne de requête trop longue. |
| 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/places' \ -H "Authorization: Bearer $ATLAS_MAPS_KEY" \ -H 'User-Agent: MonApp/1.0' \ --data-urlencode 'q=La Marsa' \ --data-urlencode 'limit=3'
{
"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"
}
}q=La Marsa&limit=3 sur le catalogue du 2 septembre 2026.