Démarrage rapide
Une clé, une variable d’environnement, un premier appel : comptez cinq minutes.
Créez une clé
Connectez-vous à votre compte Atlas, ouvrez la console développeur et créez une clé « Lieux et itinéraires ». La clé complète s’affiche une seule fois : copiez-la tout de suite.
Gardez-la côté serveur
Placez la clé dans une variable d’environnement ou le gestionnaire de secrets de votre hébergeur. Elle ne doit jamais apparaître dans une application mobile, une page web ou un dépôt Git : l’API n’accepte pas d’appels directs depuis un navigateur tiers (pas de CORS).
Terminalexport ATLAS_MAPS_KEY='atlas_maps_…'
Faites votre premier appel
Envoyez la clé dans l’en-tête
Authorizationet unUser-Agentqui identifie votre application.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'
Lisez la réponse
Les résultats sont dans
data, les informations sur la requête dansmeta. Affichez l’attributionmeta.attributionavec les résultats.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 du catalogue actuel.
Exemples complets à télécharger
Scripts autonomes, sans dépendance, avec délais d’attente et nouvelles tentatives sur 429 et 503 en respectant Retry-After.