Códigos de casa de Cabo Verde

O que é um código de casa

Cada edifício de Cabo Verde, em todas as ilhas, tem um código de casa N-Ways: o nome curto do seu bairro, zona ou povoação e um número pequeno, como Palmarejo 12 34 ou João Vaz 214. Cada código é único em todo o país por si só e leva ao portão ou à porta de entrada do lote. Os códigos são primeiro provisórios e depois confirmados quando os moradores os validam na aplicação N-Ways.

• Forma memorizada, a que as pessoas dizem e escrevem: Palmarejo 12 34. Em maiúsculas ou minúsculas, com ou sem espaços.
• Forma máquina, para sistemas, placas e ligações: PR-0973-1234-0 (município, índice nacional do nome, número, dígito de controlo).
• O nome oficial (Palmarejo Grande) e o código postal dos Correios acompanham cada código como contexto. Nunca fazem parte dele.

O modelo, o motor e os dados são abertos: github.com/n-ways/open-addresses-cabo-verde. O artigo explica cada regra.

Procurar um código

GET https://map.nways.ng/v1/homecodes/{code}, em que code é a forma máquina ou a forma memorizada, codificada para URL. Não é precisa nenhuma chave.

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"
}

Erros: 400 homecode_format quando o texto não é um código de casa; 404 homecode_unknown com uma mensagem que diz porquê (um nome que nenhuma zona tem, um número fora de todos os blocos, um dígito de controlo errado).

Qual é o código aqui?

GET https://map.nways.ng/v1/homecodes/at?lat=…&lng=… responde para um ponto: "status": "found" com o código; "none" onde nenhum edifício tem ainda um; "official" com o endereço do município onde uma Câmara numerou a rua (mostrado tal como está escrito, e sem código N-Ways); ou "official-pending" nos centros históricos cuja numeração a Câmara mantém.

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

Pesquisa

Um código de casa escrito na pesquisa N-Ways, em maiúsculas ou minúsculas, com ou sem espaços, ou uma forma máquina, encontra o portão ou a porta do lote como primeiro resultado, com "category": "homecode" e o crédito em attribution.

Descodificar offline

O motor de referência do repositório (Python, apenas a biblioteca padrão) lê as formas memorizada e máquina, verifica o dígito de controlo e descodifica um código até à sua zona sem rede: python3 engine/reference/cv_engine.py "Palmarejo 12 34". Os seus vetores de teste servem de teste de conformidade para a sua própria implementação.

Aloje-os você mesmo

Pode servir os códigos de Cabo Verde a partir dos seus próprios servidores, sem chamar o N-Ways. O repositório no GitHub contém todos os códigos emitidos (registry/), as zonas dos códigos e o modelo (model/), o motor de referência e um servidor do registo pronto a usar, com a sua API JSON:

git clone https://github.com/n-ways/open-addresses-cabo-verde
cd open-addresses-cabo-verde/server
docker compose up -d

O servidor importa o registo no primeiro arranque e depois responde às pesquisas na sua máquina; server/README.md descreve a configuração, as cópias de segurança e as atualizações, e docs/api.md cada ponto de acesso. A sua cópia é só de leitura: os códigos novos vêm de um único emissor por país, o N-Ways salvo se o Estado designar outro, para que nenhum número seja dado duas vezes. Volte a puxar o repositório para obter os códigos emitidos desde então.

Os termos completos, e a linha de crédito dos mapas e conjuntos de dados feitos a partir dos dados (que cita também o OpenStreetMap), estão em LICENSING.md. Pode dizer que o seu produto usa N-Ways Addressing, não que é o N-Ways nem que é aprovado pelo N-Ways.