AtlasDéveloppeurs
Atlas Maps API · v1 bêta

Lieux, adresses et itinéraires en Tunisie, par une API.

Trois points d’accès HTTP pour chercher un lieu, retrouver le lieu le plus proche d’une position et calculer un trajet en voiture. Les réponses viennent du catalogue Atlas, construit à partir d’OpenStreetMap.

JSON · HTTPS · clé BearerCatalogue du 2 septembre 202660 requêtes/min · 1 000/jour
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 du catalogue actuel. request_id change à chaque appel.

Points d’accès

Tous en GET, sous https://atlastunisie.com/api/maps/v1.

Point d’accèsRôleDonnéesÉtat
GET /v1/placesRecherche textuelle dans les lieux, localités, rues et adresses du catalogue Atlas.Catalogue AtlasDisponible
GET /v1/reverseGéocodage inverse : l’élément du catalogue le plus proche d’un point, dans un rayon donné.Catalogue AtlasDisponible
GET /v1/directionsTrajet routier en voiture entre deux points : distance, durée et tracé.Moteur de routage Atlas (Valhalla)Bêta

Couverture des données

Chiffres calculés sur le catalogue servi par l’API, mis à jour le 2 septembre 2026.

Éléments recherchables
61 328
Lieux, localités, rues et adresses, dans un même index.
Lieux
37 770
Dans les 24 gouvernorats ; 15 518 avec un nom arabe.
Rues
16 417
Dont 12 368 dans le Grand Tunis, plus 1 851 localités.
Adresses numérotées
5 290
Toutes dans le Grand Tunis. Ailleurs, la rue ou le lieu le plus proche.

Source : OpenStreetMap / Atlas, licence ODbL 1.0. Les dates sont des dates de génération, pas de vérification sur le terrain. Détail par gouvernorat

Pour quels produits

Des usages concrets, avec les points d’accès qu’ils mobilisent.

Livraison et logistique

Placer le point de livraison d’un client et estimer le trajet du livreur.

  • Retrouver la rue saisie par le client · places
  • Nommer le point posé sur la carte · reverse
  • Distance et durée du dépôt au client · directions

Immobilier

Situer une annonce et décrire son accès sans saisir de coordonnées.

  • Proposer la localité pendant la saisie · places
  • Nommer le repère le plus proche du bien · reverse
  • Temps de trajet vers un lieu de travail · directions

Applications et commerces

Une recherche de lieux en français et en arabe dans une application tunisienne.

  • Pharmacies, cafés, banques, écoles · places
  • « Où suis-je ? » à partir du GPS · reverse
  • Itinéraire vers un point de vente · directions

Pas encore disponible

Ces fonctions ne sont pas proposées par l’API aujourd’hui. Aucune date n’est annoncée.

  • Tuiles et fonds de carte
  • Trafic en temps réel
  • Itinéraires à pied, à vélo ou en transport en commun
  • Matrice de distances et optimisation de tournées
  • Adresses au numéro garanti hors du Grand Tunis