AtlasDéveloppeurs
Démarrer

Démarrage rapide

Une clé, une variable d’environnement, un premier appel : comptez cinq minutes.

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

  2. 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).

    Terminal
    export ATLAS_MAPS_KEY='atlas_maps_…'
  3. Faites votre premier appel

    Envoyez la clé dans l’en-tête Authorization et un User-Agent qui 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'
  4. Lisez la réponse

    Les résultats sont dans data, les informations sur la requête dans meta. Affichez l’attribution meta.attribution avec 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.