O que é uma morada postal e como se escreve

1. O que é uma morada postal
2. As partes de uma morada
3. Porque se erram as moradas
4. Normalizar e verificar: duas coisas diferentes
5. O que muda de um país para outro
6. As coordenadas e a precisão
7. O que acontece a um ficheiro
8. Moradas e duplicados
9. Perguntas frequentes

O que é uma morada postal

Uma morada postal é o percurso que leva a uma porta: o país, a cidade, a rua, o número na rua, e dentro do edifício a escada ou o andar. Cada parte restringe a anterior. Por isso uma morada é um dado com uma estrutura, e a estrutura é decidida pelos correios do país.

Os correios nacionais publicam uma norma de composição: a ordem das linhas, o que vai em maiúsculas, onde fica o número de porta, como se abrevia. Os centros de triagem leem a morada com máquinas, e uma linha fora do sítio ou um código postal genérico mandam a carta dar uma volta a mais, ou para trás.

As partes de uma morada

• Rua·um tipo (via, piazza, rue, straße, calle) e um nome. O tipo pode estar antes, depois ou colado ao nome; o nome pode ter partículas («de la», «van der») que ficam em minúsculas e abreviaturas («S.», «G.») que devem ser desenvolvidas.
• Número de porta·um número, por vezes com uma letra ou um sufixo («7a», «12/B», «14-16»), nalgumas cidades com uma cor (os números vermelhos de Génova e Florença). Vem antes ou depois da rua conforme o país, e nunca deve confundir-se com a escada, o andar ou o piso.
• Edifício·Escada, andar, porta e nome do edifício: ficam dentro do edifício, não na linha da rua, e cada país escreve-os à sua maneira. Ficam ao lado da morada, e onde o registo conhece as frações do edifício a verificação confirma-as.
• Código postal·identifica um centro de distribuição, não uma cidade: as grandes cidades têm dezenas, e nalguns países o código identifica o troço de rua ou o edifício. Tem uma forma fixa por país: cinco algarismos, quatro algarismos e duas letras, dois grupos com espaço ou hífen.
• Localidade·o município, em maiúsculas e no nome oficial. A freguesia, o bairro ou o arrondissement são informação a mais: vão no seu lugar, e a localidade continua a ser o município.
• Província ou região·onde o país a usa na morada: a sigla da província em Itália, o estado nos Estados Unidos; na Alemanha, França ou Espanha não se escreve.
• País·a última linha, em maiúsculas, na língua de quem envia; o prefixo antes do código postal (D-, F-, CH-) é um uso ultrapassado e retira-se.

Porque se erram as moradas

As moradas erram-se porque são as pessoas que as escrevem, à pressa, cada uma à sua maneira. Os erros são sempre os mesmos, e reconhecem-se.

• Abreviaturas: «v.», «p.zza», «str.», «avda.», «gt.». Quem as escreve entende-as; uma máquina não, e duas fichas da mesma pessoa não se reconhecem.
• Código postal genérico ou antigo: 20100, 00100, um código de antes da reforma. A carta chega a um centro errado.
• Freguesia em vez do município, ou o contrário: a localidade escrita é um bairro, uma aldeia absorvida, uma zona industrial, e o município não se percebe.
• Coisas fora do sítio: «a/c», «c/o», escada, andar, piso e nome do edifício dentro da linha da rua, que se torna ilegível.
• Cidade noutra língua: Munique por München, Milão por Milano, Antuérpia por Antwerpen. Os correios desse país querem-na no seu nome.
• Rua certa, número inexistente: o erro que nenhuma regra de forma vê, e que só o registo de moradas pode dizer.

Normalizar e verificar: duas coisas diferentes

Normalizar uma morada é reescrevê-la na forma postal do seu país: código postal no formato certo, abreviaturas por extenso na língua local, maiúsculas segundo o uso, número de porta onde é costume, cidade no nome local, o que não pertence deslocado para o seu lugar. Pode fazer-se com qualquer morada do mundo, porque a forma é uma regra.

Verificar uma morada é confrontá-la com o registo nacional de moradas: essa rua existe nesse município? esse número existe nessa rua? esse código postal é o dela? Só se pode fazer onde o registo está publicado e em serviço, e dá ainda as coordenadas do número de porta. Uma morada pode estar normalizada sem estar verificada; o resultado diz sempre qual das duas coisas foi feita.

Uma rua mal escrita volta a encontrar-se no registo do país: uma gralha, o tipo de via abreviado, as palavras noutra ordem. Se a correção for clara, aplica-se e declara-se; se houver mais de uma rua possível, saem como propostas e a morada fica como foi escrita.

Uma regra vale para ambas: cada alteração é declarada, e o que não se sabe não se inventa. Uma morada que não se consegue reconstruir com certeza sai com o motivo.

O que muda de um país para outro

Cada país tem a sua gramática. Os países com registo em serviço, cada um com a sua página:

Para os outros países vale a forma postal do país: código postal, abreviaturas, maiúsculas, número de porta, linha do país. A lista cresce com os registos: todos os países.

As coordenadas e a precisão

Uma morada verificada tem um ponto no mapa: latitude e longitude do número de porta, tiradas do registo nacional. Quando o número exato não existe, o ponto estima-se entre os números vizinhos da mesma rua; quando falta também isso, desce-se ao ponto da rua ou ao centro do município. O campo da precisão diz sempre a que nível se chegou — número de porta, interpolado, rua, município — para que quem usa as coordenadas saiba quanto confiar.

Onde o registo nacional não publica uma zona, o ponto pode vir do OpenStreetMap: nesse caso a fonte é declarada e a atribuição deve ser reproduzida se as coordenadas forem publicadas.

O que acontece a um ficheiro

Um ficheiro de moradas — clientes, doadores, associados — está quase sempre sujo da maneira descrita acima, e a sujidade não se vê até as cartas voltarem. Carregado tal como está, volta com uma coluna a mais por cada campo arrumado e uma coluna com o resultado: correto, alterado com o que mudou, a verificar com o motivo. As colunas que não têm a ver ficam intactas, na ordem de partida.

Podes carregar CSV, Excel, LibreOffice, JSON ou XML. Se o ficheiro não tiver a coluna do país, antes de começar escolhe o país predefinido: só vale para as linhas que não declaram nenhum.

As linhas a verificar são normalmente poucas, e são as que nenhuma regra pode decidir: uma rua que não consta no município, um número que não existe. Aí é precisa uma pessoa, e o resultado põe-nas em fila. Como preparar o ficheiro está nesta página.

Moradas e duplicados

A mesma pessoa na mesma morada, escrita de duas maneiras, é o duplicado mais comum de uma base de dados, e o mais difícil de ver com uma folha de cálculo: «v. Leopardi 4» e «Via Giacomo Leopardi, 4» são cadeias diferentes. Normalizar as moradas antes da comparação faz as duas grafias convergir para a mesma forma; para as moradas estrangeiras uma chave de comparação faz o mesmo trabalho na língua do país («350 Fifth Avenue» e «350 5th Ave» coincidem).

Depois a comparação olha para o nome — diminutivos, iniciais, apelido e nome invertidos, gralhas — e para os contactos, e dá um nível de certeza a cada grupo. Como funciona está em desduplicação.

Perguntas frequentes