Codes d’adresse du Togo

Ce qu’est un code

Chaque concession du Togo a un code d’adresse N-Ways : le nom court de son quartier, de son village ou de son canton et un numéro de quatre ou cinq chiffres, comme Fréau-Jardin 1058 ou Zongo 14198. Chaque code est unique dans tout le pays à lui seul et mène au portail de la concession. Les codes sont d’abord provisoires, puis confirmés quand les habitants les confirment dans l’application N-Ways.

• Forme retenue, celle que les gens disent, tapent et écrivent sur les plaques : Fréau-Jardin 10 58, aussi sans espace (Fréau-Jardin 1058) ou avec des points. Toute casse et les orthographes courantes (Djanta Copé = Djanta kopé, Lom-Nava = Lom Nava), le nom officiel à la place du nom court (Adjahun Fiagbe 1017 = Fiagbe 1017). Les gens ne voient ni ne tapent jamais de chiffre de contrôle.
• Forme machine, pour les systèmes, les QR codes et les liens : TG-FRJ-1058-2 (la zone, le numéro et un chiffre de contrôle de Damm qui détecte tout chiffre faux et toute inversion de deux chiffres voisins ; .2/1 après pour le bâtiment 2, portail 1).
• Code de point, pour n’importe quel point : FRJ-54-4R, une maille d’environ 3,4 m cadrée sur son quartier ou son canton ; chaque fiche porte aussi le Plus Code de son portail (6FR346JF+P96).
• Les codes de rues de Lomé comme 165 AMT sont des références officielles de rues, pas des codes N-Ways : l’API le dit et ne les décode jamais.

Dans l’ancienne commune de Lomé, la rue officielle vient en premier, dans officialAddress avec "coverage": "official-street" ; l’adresse d’entrée du District Autonome du Grand Lomé prendra sa place dès sa publication. Aucune préfecture ni commune n’est nécessaire pour décoder un code ; municipality est déduit de la position. Le modèle, le moteur et le registre de tous les codes sont ouverts : github.com/n-ways/open-addresses-togo. Le livre blanc explique chaque règle.

Chercher un code

GET https://map.nways.ng/v1/homecodes/{code}, où code est la forme retenue ou machine, ou le code de point d’une concession, encodé pour l’URL. Aucune clé n’est nécessaire.

curl "https://map.nways.ng/v1/homecodes/TG-FRJ-1058-2"

{
  "country": "TG",
  "home": "Fréau-Jardin 1058",
  "machine": "TG-FRJ-1058-2",
  "check": 2,
  "name": "Fréau-Jardin",
  "coverage": "official-street",
  "officialAddress": "Rue Mission Tové, Lomé",
  "nameProvisional": false,
  "municipality": "Lomé",
  "fullLine": "Fréau-Jardin 10 58",
  "spoken": "Fréau-Jardin, 10 58",
  "status": "provisional",
  "issued": "bulk",
  "entrance": { "lat": 6.1317765, "lng": 1.2234008, "kind": "centre", "source": "map" },
  "location": { "lat": 6.1317765, "lng": 1.2234008 },
  "plusCode": "6FR346JF+P96",
  "lote": { "use": "residential", "kind": "building", "class": "residential", "structures": 1, "floorAreaM2": 19.5, "rule": "single", "official": "Rue Mission Tové, Lomé" },
  "credit": "N-Ways Addressing for Togo, © N-WAYS LIMITED (nways.ng)",
  "creditUrl": "https://github.com/n-ways/open-addresses-togo"
}

Erreurs : 400 homecode_format quand le texte n’est pas un code (un code de rue de Lomé le dit) ; 404 homecode_unknown avec un message qui dit pourquoi (un nom qu’aucune zone ne porte, un numéro hors de tout bloc de son nom).

Quel est le code ici ?

GET https://map.nways.ng/v1/homecodes/at?lat=…&lng=… répond pour un point : "status": "found" avec le code, ou "none" là où aucune concession n’en a encore.

curl "https://map.nways.ng/v1/homecodes/at?lat=6.13178&lng=1.22340"

Recherche

Un code tapé dans la recherche N-Ways, sous n’importe quelle forme, trouve le portail de la concession en premier résultat, avec "category": "homecode" et le crédit dans attribution.

Décoder hors ligne

Le moteur de référence du dépôt (Python, bibliothèque standard seulement) décode chaque forme, vérifie la forme machine et lit et écrit les codes de point, sans réseau : python3 engine/reference/tg_engine.py parse "Fréau-Jardin 10 58". Ses vecteurs de conformité (engine/reference/vectors.json) servent de test à votre propre implémentation, engine/data/register.json contient chaque zone et chaque nom avec ses blocs figés, et registry/ chaque code émis, un fichier gzip par préfecture.

Hébergez-les vous-même

Vous pouvez servir les codes du Togo depuis vos propres serveurs, sans appeler N-Ways. Le dépôt GitHub contient chaque code émis (registry/), les zones des codes et le modèle (model/), le moteur de référence et un serveur du registre prêt à l’emploi, avec son API JSON :

git clone https://github.com/n-ways/open-addresses-togo
cd open-addresses-togo/server
docker compose up -d

Le serveur importe le registre au premier démarrage, puis répond aux recherches sur votre machine ; server/README.md décrit la configuration, les sauvegardes et les mises à jour, et docs/api.md chaque point d’accès. Votre copie est en lecture seule : les nouveaux codes viennent d’un seul émetteur par pays, N-Ways sauf si l’État en désigne un autre, pour qu’aucun numéro ne soit jamais donné deux fois. Tirez à nouveau le dépôt pour les codes émis depuis.

Les conditions complètes, et la ligne de crédit des cartes et jeux de données tirés des données (elle cite aussi OpenStreetMap), sont dans LICENSING.md. Vous pouvez dire que votre produit utilise N-Ways Addressing, pas qu’il est N-Ways ni qu’il est approuvé par N-Ways.