Codes d’adresse de la Sierra Leone

Ce qu’est un code

Chaque concession de Sierra Leone a un code d’adresse N-Ways : le nom court de sa communauté, de sa ville ou de son village et un numéro de trois à cinq chiffres, comme Moyamba 15727 ou Connaught 2301. 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 : Moyamba 15727, aussi par groupes (moyamba 157 27). Toute casse, graphies krio et anglaises (Kissy Tong = Kissy Town), le nom officiel à la place du nom court (Gbangbatoke Junction 1051 = Gbangbatoke 1051).
• Forme écrite, sur les plaques et les formulaires : Moyamba 157 27, avec le Plus Code du portail. Les gens ne voient ni ne tapent jamais de chiffre de contrôle ; l’API le renvoie dans check pour les systèmes.
• Forme machine, pour les systèmes, les QR codes et les liens : SL-03663-15727 (la zone, le numéro ; SL-03663-15727.2/3 pour le bâtiment 2, unité 3).
• Code de point, pour tout point : son Plus Code, 5H68+3V Moyamba ou 6CW95H68+3V, lisible par toute application Plus Code.

Dans la zone du conseil municipal de Freetown, le Plus Code de la propriété est l’adresse officielle : il vient en premier, dans officialAddress, avec le code N-Ways à côté. Aucun district, aucune chefferie ni aucun quartier ne fait partie d’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-sierra-leone. Le livre blanc explique chaque règle.

Chercher un code

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

curl "https://map.nways.ng/v1/homecodes/SL-03663-15727"

{
  "country": "SL",
  "home": "Moyamba 15727",
  "machine": "SL-03663-15727",
  "check": 0,
  "name": "Moyamba",
  "nameProvisional": false,
  "municipality": "Moyamba District",
  "fullLine": "Moyamba 157 27 · Moyamba District",
  "spoken": "Moyamba, 157 27",
  "status": "provisional",
  "issued": "bulk",
  "entrance": { "lat": 8.1602399, "lng": -12.4327947, "kind": "centre", "source": "map" },
  "location": { "lat": 8.1602399, "lng": -12.4327947 },
  "plusCode": "6CW95H68+3VW",
  "lote": { "use": "residential", "kind": "building", "class": "unknown", "structures": 1, "floorAreaM2": 888.7, "rule": "single" },
  "credit": "N-Ways Addressing for Sierra Leone, © N-WAYS LIMITED (nways.ng)",
  "creditUrl": "https://github.com/n-ways/open-addresses-sierra-leone"
}

À Freetown, la fiche porte d’abord le Plus Code du conseil :

{
  "home": "Connaught 2301",
  "machine": "SL-00623-2301",
  "officialName": "Connaught Hospital Community",
  "coverage": "official",
  "officialAddress": "FQQ6+9G Freetown",
  "municipality": "Freetown",
  "fullLine": "Connaught 23 01 · Freetown",
  "lote": { "use": "health", "class": "health", "official": "FQQ6+9G Freetown" }
}

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 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=8.16024&lng=-12.43279"

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 lit et écrit les Plus Codes, sans réseau : python3 engine/reference/sl_address.py decode "Moyamba 157 27". Ses vecteurs de conformité (engine/reference/vectors.json) sont le test de votre propre implémentation, engine/data/register.json contient chaque zone et ses blocs figés, et registry/ chaque code émis, un fichier gzip par zone Plus Code de 4 caractères.

Hébergez-les vous-même

Vous pouvez servir les codes de la Sierra Leone 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-sierra-leone
cd open-addresses-sierra-leone
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.