Codes d’adresse du Gabon

Ce qu’est un code

Chaque concession du Gabon a un code d’adresse N-Ways : le nom court de son quartier ou de son village et un numéro de trois à cinq chiffres, comme Louis 1201 ou Mont-Bouët 1957. Chaque code est unique dans tout le pays à lui seul et mène au portail de la concession. Les codes commencent provisoires et deviennent confirmés quand les habitants sont d’accord dans l’application N-Ways.

• Forme retenue, celle que les gens disent, tapent et écrivent sur les plaques : Louis 12 01, aussi sans l’espace (Louis 1201) ; cinq chiffres se lisent comme une paire et une centaine (Port-Gentil 12 181, Libreville 11 001). Toute casse, avec ou sans accents (mont bouet 1957 trouve Mont-Bouët 1957), et le nom officiel à la place du nom court (Derrière l’Hôpital 11001 trouve Libreville 11001). 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 : GA-1LV-070-1201-1 (le département, 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).
• Code de point, pour n’importe quel point : GA-1LV E0794 N0757, une maille de 10 m de la grille de son département ; chaque fiche porte aussi le Plus Code de son portail (6FGFCC5J+CH2).

Sur une rue nommée de Libreville, la rue vient en premier, dans officialAddress avec "coverage": "official-street" ; un numéro de porte du plan communal la remplace dès qu’il est connu. Aucun département n’est nécessaire pour décoder un code ; municipality est déduit de la position. Le modèle, le moteur, le registre de tous les codes et un serveur prêt à l’emploi sont ouverts : github.com/n-ways/open-addresses-gabon. L’article de recherche explique chaque règle.

Chercher un code

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

curl "https://map.nways.ng/v1/homecodes/GA-1LV-070-1201-1"

{
  "country": "GA",
  "home": "Louis 1201",
  "machine": "GA-1LV-070-1201-1",
  "check": 1,
  "name": "Louis",
  "coverage": "official-street",
  "officialAddress": "Avenue Joseph Deemin, Libreville",
  "nameProvisional": false,
  "municipality": "Libreville",
  "fullLine": "Louis 12 01",
  "spoken": "Louis, 12 01",
  "status": "provisional",
  "issued": "bulk",
  "entrance": { "lat": 0.4085002, "lng": 9.4314043, "kind": "centre", "source": "map" },
  "location": { "lat": 0.4085002, "lng": 9.4314043 },
  "plusCode": "6FGFCC5J+CH2",
  "lote": { "class": "residential", "coverage": "official-street", "enclosed": false, "floorAreaM2": 122.2, "kind": "building", "official": "Avenue Joseph Deemin, Libreville", "rule": "single", "structures": 1, "use": "residential" },
  "credit": "N-Ways Addressing for Gabon, © N-WAYS LIMITED (nways.ng)",
  "creditUrl": "https://github.com/n-ways/open-addresses-gabon"
}

Erreurs : 400 homecode_format quand le texte n’est pas un code ; 404 homecode_unknown avec un message qui dit pourquoi (un nom qu’aucune zone ne porte, un numéro dans aucun 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. Ce point de Libreville répond Libreville 11001.

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

Recherche

Un code tapé dans la recherche N-Ways, sous n’importe laquelle de ses formes, 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 toutes les formes, vérifie la forme machine et lit et écrit les codes de point, sans réseau : python3 engine/reference/ga_engine.py resolve Louis 12 01. Ses vecteurs de conformité (engine/reference/vectors.json) sont le test de votre propre implémentation, et engine/data/register.json contient chaque zone et chaque nom avec ses blocs figés. registry/ contient chaque code émis, un fichier par département, et le serveur du registre dans server/ le sert depuis votre propre machine.

Hébergez-les vous-même

Vous pouvez servir les codes du Gabon 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-gabon
cd open-addresses-gabon/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.