Codes d’adresse de la Gambie

Ce qu’est un code d’adresse

Chaque concession de Gambie, dans les 7 zones, a un code d’adresse N-Ways : le nom court de sa ville, de son village ou de son quartier et un numéro court, comme Bakau 2389 ou Banjul 19 474. 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 valident dans l’application N-Ways.

• L’adresse officielle est celle du gouvernement : le Plus Code du portail avec sa ville, F8HC+9G6 Bakau (Politique nationale d’adressage numérique, 2023). Affichez-la en premier. L’adresse de rue d’un conseil, si elle est connue, passe avant.
• Forme courante, celle que les gens disent et tapent : Bakau 2389. Majuscules, graphies gambiennes (Keur = Kerr), avec ou sans espaces.
• Forme écrite, sur les plaques et les formulaires : BAKAU 2389 · KANIFING (avec la zone). 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 : GM-KMC-0001-2389-6 (zone, indice du lieu, numéro, chiffre de contrôle).

Le modèle, le moteur et le registre de tous les codes sont ouverts : github.com/n-ways/open-addresses-gambia. Le livre blanc explique chaque règle.

Chercher un code

GET https://map.nways.ng/v1/homecodes/{code}, où code est la forme courante ou machine, encodée pour l’URL. Aucune clé n’est nécessaire.

curl "https://map.nways.ng/v1/homecodes/Bakau%202389"

{
  "country": "GM",
  "home": "Bakau 2389",
  "machine": "GM-KMC-0001-2389-6",
  "name": "Bakau",
  "nameProvisional": false,
  "municipality": "Kanifing",
  "coverage": "official",
  "officialAddress": "F8HC+9G6 Bakau",
  "fullLine": "BAKAU 2389 · KANIFING",
  "spoken": "Bakau, twenty-three, eighty-nine",
  "status": "provisional",
  "issued": "bulk",
  "entrance": { "lat": 13.47841, "lng": -16.6787355, "kind": "centre", "source": "map" },
  "location": { "lat": 13.47841, "lng": -16.6787355 },
  "plusCode": "7C55F8HC+9G6",
  "lote": { "use": "residential", "class": "res.maison", "kind": "un_batiment", "structures": 1, "floorAreaM2": 113.1, "enclosed": false },
  "credit": "N-Ways Addressing for The Gambia, © N-WAYS LIMITED (nways.ng)",
  "creditUrl": "https://github.com/n-ways/open-addresses-gambia"
}

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 mauvais chiffre de contrôle).

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=13.4784&lng=-16.6787"

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 toutes les formes, vérifie le chiffre de contrôle et calcule le Plus Code du gouvernement, sans réseau : python3 engine/reference/gm_engine.py find "Bakau 2389". Ses vecteurs de test sont le test de conformité de votre implémentation, et registry/ contient tous les codes attribués, un fichier gzip par zone.

Hébergez-les vous-même

Vous pouvez servir les codes de la Gambie 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-gambia
cd open-addresses-gambia
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.