Géocodage inverse (reverse)

Convertissez une paire de coordonnées GPS en adresse postale lisible (rue, commune, délégation, gouvernorat).

L’endpoint Reverse Geocoding prend une paire lat / lng et renvoie l’adresse postale correspondante avec sa décomposition administrative (commune, délégation, gouvernorat).

Endpoint

GET https://api.tmaps.tn/geocoding/reverse?lat=...&lng=...&api_key=YOUR_API_KEY

Paramètres

Paramètres de query

Param	Type	Requis	Défaut	Description
`lat`	number	oui	—	Latitude WGS84 en degrés décimaux (entre `-90` et `90`).
`lng`	number	oui	—	Longitude WGS84 en degrés décimaux (entre `-180` et `180`).
`api_key`	string	oui	—	Votre clé API TMaps.
`lang`	string	—	`fr`	Langue de l'adresse formatée : `fr`, `en` ou `ar`.
`type`	string	—	—	Type cible : `address`, `street`, `poi`, `locality`. Utile pour forcer un résultat locality quand on ne veut que la commune.
`limit`	integer	—	`1`	Nombre maximum de résultats (1 → 5).

Exemple de requête

curl "https://api.tmaps.tn/geocoding/reverse?lat=36.8002&lng=10.1815&lang=fr&api_key=YOUR_API_KEY"

Réponse

{
"query": { "lat": 36.8002, "lng": 10.1815 },
"results": [
  {
    "lat": 36.8002,
    "lng": 10.1815,
    "formatted": "Avenue Habib Bourguiba, 1001 Tunis, Tunisie",
    "distance": 4.2,
    "type": "address",
    "components": {
      "street": "Avenue Habib Bourguiba",
      "postcode": "1001",
      "commune": "Tunis",
      "delegation": "Tunis Médina",
      "governorate": "Tunis",
      "country": "TN"
    }
  }
]
}

Champs renvoyés

Champ d'un résultat

Param	Type	Requis	Défaut	Description
`lat`	number	—	—	Latitude du point trouvé (peut différer de la requête si snap sur un objet).
`lng`	number	—	—	Longitude du point trouvé.
`formatted`	string	—	—	Adresse complète formatée.
`distance`	number	—	—	Distance en mètres entre la requête et le point trouvé.
`type`	string	—	—	Type de résultat : `address`, `street`, `poi`, `locality`.
`components`	object	—	—	Détail administratif : `street`, `postcode`, `commune`, `delegation`, `governorate`, `country`.

Snap sur la rue ou le bâtiment le plus proche

Si la coordonnée envoyée tombe au milieu d’une rue ou à 30 m d’un bâtiment, l’API renvoie le point le plus proche pertinent et expose la distance dans distance.

Cas d’usage

Apps mobiles : afficher l’adresse de la position GPS de l’utilisateur.
Tournées d’inspection : associer chaque point GPS terrain à une adresse cadastrale.
Logs et audits : enrichir des coordonnées brutes avec le contexte administratif.

Erreurs

Statut	Cause
`400`	`lat` ou `lng` manquant, ou hors plage
`401`	`api_key` manquant ou révoqué
`403`	Domaine non autorisé
`404`	Aucune adresse trouvée à proximité

Voir Codes d’erreur pour la liste complète.