Codes d’adresse de la Guinée

Ce qu’est un code

Chaque concession de Guinée, dans les cinq régions postales, a un code d’adresse N-Ways : le nom court de son quartier, de sa ville ou de son village et un numéro de quatre ou cinq chiffres, comme Hafia 3 · 1230 ou Linsan 5389. 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, ce que l’on dit et tape : Hafia 3 · 1230, aussi tapé par paires (hafia 3 12 30). Toute casse et tous accents, le nom officiel à la place du nom court (Missidé Bhoundou Kalouma 1260 = Kalouma 1260). Un nom qui finit par un nombre prend un · avant le numéro du logement.
• Forme plaque, sur les plaques et les formulaires : HAFIA 3 · 1230. Les gens ne voient ni ne tapent jamais de chiffre de contrôle ; il n’est que dans la forme machine.
• Forme machine, pour les systèmes, les QR codes et les liens : GN-04261-1230-8 (l’identifiant national du nom, le numéro, le chiffre de contrôle ; GN-04261-1230.2-3 pour le deuxième bâtiment de la concession).
• Code de point, pour tout carré de 3 m : 0 22JV PVQQ, calculé hors ligne ; ses cinq premiers caractères, 0 22JV, sont le code de bloc de 1,2 km.

Aucune commune, préfecture ni région ne fait partie d’un code : les réformes de 2024 et 2026 n’en changent aucun ; municipality est déduit de la position. À Kaloum, la rue officielle du programme national d’adressage vient en premier, dans officialAddress. Le modèle, le moteur et le registre de tous les codes sont ouverts : github.com/n-ways/open-addresses-guinea. Le livre blanc explique chaque règle.

Chercher un code

GET https://map.nways.ng/v1/homecodes/{code}, où code est la forme retenue, plaque 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/GN-04261-1230-8"

{
  "country": "GN",
  "home": "Hafia 3 · 1230",
  "machine": "GN-04261-1230-8",
  "check": 8,
  "name": "Hafia 3",
  "nameProvisional": false,
  "municipality": "Dixinn, Conakry",
  "fullLine": "Hafia 3 · 1230 · Dixinn, Conakry",
  "spoken": "Hafia 3, douze trente",
  "status": "provisional",
  "issued": "bulk",
  "entrance": { "lat": 9.5682034, "lng": -13.6544537, "kind": "centre", "source": "map" },
  "location": { "lat": 9.5682034, "lng": -13.6544537 },
  "plusCode": "6CX8H89W+76M",
  "lote": { "use": "residential", "kind": "compound", "class": "residential.house", "structures": 2, "floorAreaM2": 206.4, "settlement": "town", "rule": "annex" },
  "credit": "N-Ways Addressing for Guinea, © N-WAYS LIMITED (nways.ng)",
  "creditUrl": "https://github.com/n-ways/open-addresses-guinea"
}

À Kaloum, la fiche porte d’abord la rue officielle :

{
  "home": "Almamiya 1939",
  "machine": "GN-00053-1939-4",
  "coverage": "official-street",
  "officialAddress": "Avenue Dinah Salifou, Kaloum",
  "municipality": "Kaloum, Conakry",
  "fullLine": "Almamiya 1939 · Kaloum, Conakry"
}

Erreurs : 400 homecode_format quand le texte n’est pas un code ; 404 homecode_unknown avec un message qui dit pourquoi (un nom qu’aucun lieu ne porte, un numéro hors de tout bloc, un chiffre de contrôle faux).

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=9.56820&lng=-13.65445"

Recherche

Un code tapé dans la recherche N-Ways, sous n’importe laquelle de ses formes, donne le portail de la concession comme 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 le chiffre de contrôle et calcule les codes de point et de bloc, sans réseau : python3 engine/reference/gn_codes.py home "Hafia 3 · 1230". Ses vecteurs de conformité (engine/reference/vectors.json) sont le test de votre propre implémentation, engine/data/register.json contient chaque lieu et ses blocs figés, et registry/ chaque code émis, un fichier gzip par région postale.

Hébergez-les vous-même

Vous pouvez servir les codes de la Guinée 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-guinea
cd open-addresses-guinea
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.