Guia

Guia de moradas

Uma morada parece quatro campos para preencher. É uma frase com uma gramática, diferente em cada país, que serve a uma pessoa para encontrar uma porta. Este guia diz de que partes é feita, porque se erra tantas vezes, o que quer dizer pô-la em ordem e o que quer dizer verificá-la.

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 não é um texto livre: é um dado com uma estrutura, e a estrutura é decidida pelos correios do país, não por quem escreve.

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. Respeitá-la não é pedantismo: 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.
  • 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, não um município: 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 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, não com uma versão plausível.

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:

PaísNúmero de portaCódigo postalRegisto
Itália depois da rua 5 algarismos todos os municípios
Alemanha depois da rua 5 algarismos 16 740 631 números de porta
França antes da rua 5 algarismos 26 068 644 números de porta
Espanha depois da rua 5 algarismos 15 428 192 números de porta
Países Baixos depois da rua 4 algarismos e 2 letras 10 066 060 números de porta
Portugal depois da rua 4 + 3 algarismos 2 681 620 números de porta
Bélgica depois da rua 4 algarismos 5 512 942 números de porta
Suíça depois da rua 4 algarismos 2 444 868 números de porta
Liechtenstein depois da rua 4 algarismos 12 729 números de porta
Chéquia depois da rua 3 + 2 algarismos 3 020 881 números de porta
Dinamarca depois da rua 4 algarismos 2 614 616 números de porta
Noruega depois da rua 4 algarismos 2 568 657 números de porta
Finlândia depois da rua 5 algarismos 5 255 497 números de porta
Áustria depois da rua 4 algarismos 2 505 721 números de porta
Eslovénia depois da rua 4 algarismos 655 408 números de porta
Luxemburgo antes da rua L- e 4 cifre 178 959 números de porta
Hungria depois da rua 4 algarismos 731 695 números de porta
Roménia depois da rua 6 cifre 1 003 609 números de porta
Irlanda antes da rua Eircode 547 989 números de porta
Eslováquia depois da rua 3 + 2 algarismos 1 896 376 números de porta
Islândia depois da rua 3 cifre 231 230 números de porta
Croácia depois da rua 5 algarismos 1 682 480 números de porta
Andorra depois da rua AD e 3 cifre 343 números de porta
Mónaco antes da rua 5 algarismos 351 números de porta
San Marino depois da rua 5 algarismos 11 495 números de porta
Cidade do Vaticano depois da rua 5 algarismos 130 números de porta

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.

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

Qual é a diferença entre normalizar e verificar uma morada?

Normalizar é escrevê-la na forma postal do seu país: código postal no formato certo, abreviaturas por extenso, maiúsculas segundo o uso, número de porta no sítio certo. Verificar é 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. A forma pode dar-se a qualquer morada do mundo; a verificação só onde o registo está em serviço.

Uma morada normalizada é necessariamente correta?

Não. Uma morada pode estar perfeitamente escrita e não existir: uma rua que não há no município, um número nunca atribuído. Por isso a forma e a verificação são duas coisas diferentes, e o resultado diz qual das duas foi feita.

Porque não chega o código postal genérico?

Nas grandes cidades o código postal muda de uma rua para outra, e por vezes ao longo da mesma rua. Um código genérico (20100 para Milão, 00100 para Roma) é aceite pelos formulários mas não identifica o centro de distribuição: a carta dá uma volta a mais, ou volta para trás.

O que acontece se uma morada não puder ser verificada?

Fica na forma postal do país, com um resultado que diz porquê: rua não encontrada no município, número não encontrado, dados insuficientes. Nunca é substituída por uma morada plausível: uma dúvida declarada vale mais do que uma certeza inventada.

As moradas verificadas têm coordenadas?

Onde o registo nacional as tem, sim: latitude e longitude do número de porta. Quando falta o número exato, o ponto estima-se a partir dos números vizinhos ou desce-se à rua ou ao município, e o campo da precisão diz a que nível chegámos.

Experimente com uma morada

Uma morada de cada vez a partir do site, um ficheiro inteiro a partir da área pessoal, ou a API dentro da tua aplicação.