Documentacao tecnica

Documentacao dos dados postais e esquema CSV

Defina as suas integracoes com a nossa estrutura global de codigos postais, coordenadas e niveis administrativos.

Esquema geoespacial, formatos de exportacao e referencia WGS84

Todas as coordenadas sao publicadas em WGS84 e em graus decimais para manter compatibilidade com SIG, mapas web e tratamentos analiticos.

Campo	Padrao	Notas
Latitude / Longitude	WGS84	Ate 6 decimais consoante a fonte
Codificacao	UTF-8	Compatibilidade internacional
Codigos de pais	ISO 3166-1 alpha-2	Valores com 2 letras

Formatos disponiveis

Publicamos as bases em formatos simples para integracao aplicacional, analise e importacao bulk.

📄

CSV
Importacao e scripts

📊

XLSX
Controlo manual

{}

JSON
API e pipelines

Hierarquia administrativa

Para harmonizar os paises, projetamos as estruturas nacionais numa hierarquia comum.

Admin level 1: regiao, provincia, estado ou equivalente.

Admin level 2: distrito, departamento ou prefeitura.

Admin level 3: municipio, bairro ou subdivisao local.

Place name: localidade principal associada ao codigo.

Versionamento e manutencao

Trabalhamos com snapshots e atualizacoes progressivas para manter a estabilidade das integracoes enquanto absorvemos alteracoes nos registos nacionais.

Compatibilidade: os campos principais mantem-se estaveis e as alteracoes estruturais relevantes sao documentadas.