Codes d’adresse du Cap-Vert

Ce qu’est un code d’adresse

Chaque bâtiment du Cap-Vert, sur toutes les îles, a un code d’adresse N-Ways : le nom court de son bairro, de sa zona ou de sa povoação et un petit numéro, comme Palmarejo 12 34 ou João Vaz 214. Chaque code est unique dans tout le pays à lui seul et mène au portail ou à la porte d’entrée du lote. Les codes sont d’abord provisoires, puis confirmés quand les habitants les valident dans l’application N-Ways.

• Forme courante, celle que les gens disent et tapent : Palmarejo 12 34. En majuscules ou minuscules, avec ou sans espaces.
• Forme machine, pour les systèmes, les plaques et les liens : PR-0973-1234-0 (municipalité, indice national du nom, numéro, chiffre de contrôle).
• Le nom officiel (Palmarejo Grande) et le code postal des Correios accompagnent chaque code comme contexte. Ils n’en font jamais partie.

Le modèle, le moteur et les données sont ouverts : github.com/n-ways/open-addresses-cabo-verde. Le livre blanc explique chaque règle.

Chercher un code

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

curl "https://map.nways.ng/v1/homecodes/Palmarejo%2012%2034"

{
  "country": "CV",
  "home": "Palmarejo 12 34",
  "machine": "PR-0973-1234-0",
  "check": 0,
  "name": "Palmarejo",
  "officialName": "Palmarejo Grande",
  "nameProvisional": true,
  "municipality": "Praia",
  "island": "Santiago",
  "postcode": { "value": "7600", "kind": "area", "source": "Correios de Cabo Verde (UPU 2014)" },
  "fullLine": "Palmarejo 12 34 · Palmarejo Grande · Praia, Santiago · 7600",
  "spoken": "Palmarejo, doze, trinta e quatro",
  "status": "provisional",
  "issued": "bulk",
  "entrance": { "lat": 14.9201, "lng": -23.5402, "kind": "door", "source": "map" },
  "location": { "lat": 14.9201, "lng": -23.5402 },
  "plusCode": "796RWFC5+2WV",
  "lote": { "use": "residencial", "structures": 1, "floorAreaM2": 120, "enclosed": false },
  "credit": "Home code by N-Ways Addressing",
  "creditUrl": "https://github.com/n-ways/open-addresses-cabo-verde"
}

Erreurs : 400 homecode_format quand le texte n’est pas un code d’adresse ; 404 homecode_unknown avec un message qui dit pourquoi (un nom qu’aucune zone ne porte, un numéro hors de tous les blocs, 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 ; "none" là où aucun bâtiment n’en a encore ; "official" avec l’adresse de la municipalité là où une Câmara a numéroté la rue (affichée telle qu’elle est écrite, et sans code N-Ways) ; ou "official-pending" dans les centres historiques dont la Câmara garde la numérotation.

curl "https://map.nways.ng/v1/homecodes/at?lat=14.9201&lng=-23.5402"

Recherche

Un code d’adresse tapé dans la recherche N-Ways, en majuscules ou minuscules, avec ou sans espaces, ou une forme machine, trouve le portail ou la porte du lote 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) lit les formes courante et machine, vérifie le chiffre de contrôle et décode un code jusqu’à sa zone sans réseau : python3 engine/reference/cv_engine.py "Palmarejo 12 34". Ses vecteurs de test servent de test de conformité pour votre propre implémentation.

Hébergez-les vous-même

Vous pouvez servir les codes du Cap-Vert 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-cabo-verde
cd open-addresses-cabo-verde/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.