Codes d’adresse de la Guinée-Bissau

Ce qu’est un code

Chaque concession de Guinée-Bissau, dans les 39 secteurs, a un code N-Ways : le nom court de son bairro, de sa ville ou de sa tabanca et un numéro court, comme Bandim 537 ou Gabu 1203. 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.

• Forme retenue, celle qu’on dit et qu’on tape : Bandim 537. Majuscules ou non, graphies portugaises et kriol (Sintchã = Sinchã), le nom officiel à la place du nom court.
• Forme écrite, sur les plaques et les formulaires : Bandim 537. 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 : 10-022-00537-4 (secteur, lieu, numéro, chiffre de contrôle).
• Code de point, pour tout point sans concession : 10-4327-9117, calculé hors ligne.

La Guinée-Bissau n’a pas de système d’adresses officiel : ses codes postaux n’existent que sur le papier, et seul 1000 BISSAU est attesté ; il est affiché à côté des codes de Bissau, pour le contexte. Le modèle, le moteur et le registre de tous les codes sont ouverts : github.com/n-ways/open-addresses-guinea-bissau. 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 code de point sur une concession, encodé pour l’URL. Aucune clé n’est nécessaire.

curl "https://map.nways.ng/v1/homecodes/Bandim%20537"

{
  "country": "GW",
  "home": "Bandim 537",
  "machine": "10-022-00537-4",
  "check": 4,
  "name": "Bandim",
  "nameProvisional": false,
  "municipality": "Bissau",
  "postcode": { "value": "1000", "kind": "area", "source": "UPU" },
  "fullLine": "Bandim 537 · Bissau",
  "spoken": "Bandim, quinhentos e trinta e sete",
  "status": "provisional",
  "issued": "bulk",
  "entrance": { "lat": 11.8521485, "lng": -15.5950371, "kind": "centre", "source": "map" },
  "location": { "lat": 11.8521485, "lng": -15.5950371 },
  "plusCode": "7C36VC23+VX4",
  "lote": { "use": "residential", "kind": "building", "class": "residential.compound-house", "structures": 1, "floorAreaM2": 272.4, "settlement": "cidade" },
  "credit": "N-Ways Addressing for Guinea-Bissau, © N-WAYS LIMITED (nways.ng)",
  "creditUrl": "https://github.com/n-ways/open-addresses-guinea-bissau"
}

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 tous les blocs, 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=11.85215&lng=-15.59504"

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 les codes de point, sans réseau : python3 engine/reference/gw_codes.py "Bandim 537". Ses vecteurs de test (engine/reference/vectors.json) sont le test de conformité de votre propre implémentation, et registry/ contient tous les codes attribués, un fichier gzip par secteur.

Hébergez-les vous-même

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