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ís | Número de porta | Código postal | Registo |
|---|---|---|---|
| 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.