RadarAddress address · data · quality

Países · Portugal

Portugal: como se escreve uma morada e o que verificamos

Cada morada do país volta na forma postal nacional e é confrontada com o registo nacional de moradas: rua, número de porta, código postal, coordenadas. Aqui encontras como se escreve uma morada lá, o que controlamos e três exemplos antes e depois.

Experimente com uma morada Documentação da API

Como é feita uma morada

  • Número de porta·depois da rua («Hauptstraße 5»)
  • Código postal·4 + 3 algarismos; o prefixo do país à frente (D-, F-, CH-) é retirado
  • Localidade·em maiúsculas, no nome local
  • País·linha do país e código ISO, na língua de quem lê

O código postal português tem sete algarismos em dois grupos («1100-053») e o segundo grupo identifica o troço de rua: sem ele, o registo não confirma o número de porta. O número segue a rua; o registo nacional é feito de alojamentos, pelo que os edifícios públicos sem habitações podem faltar, enquanto as ruas comerciais do centro estão todas.

O que verificamos

Moradas: todo o país · códigos postais: 98% · dados da fonte a 31 dez 2017, mais recentes nos municípios que publicam o seu próprio registo.

  • Rua·existe no município, escrita por extenso e na grafia do registo; as abreviaturas são desenvolvidas na língua do país
  • Número de porta·existe nessa rua; se a rua existe e o número não, o resultado assinala-o
  • Código postal·confirmado ou completado pelo registo, no formato do país
  • Coordenadas·latitude e longitude do número de porta, com a precisão declarada
  • Preenchimento automático·a rua completa-se enquanto escreves, a partir do registo; o número e o código postal chegam com a seleção (API)
  • WooCommerce · PrestaShop·preenchimento automático no checkout e verificação das encomendas com os plugins

Fonte: Instituto Nacional de Estatística, I.P. — Base Nacional de Moradas; Câmaras Municipais de Cascais, Oeiras, Matosinhos e Nordeste (Açores); CIM Alto Tâmega e Barroso; © OpenStreetMap contributors · CC BY 4.0; ODbL

Antes e depois

Três moradas escritas como as pessoas as escrevem — abreviadas, sem código postal, em minúsculas — e como saem: edifícios públicos e ruas do centro, verificadas até ao número de porta.

  • rua augusta 100, 1100053 lisboa → Rua Augusta 100
    1100-053 LISBOA coordenadas do número de porta
  • r. de santa catarina, 110, 4000 porto → Rua de Santa Catarina 110
    4000-442 PORTO código postal corrigido · rua escrita por extenso · coordenadas do número de porta
  • PRAÇA DA REPÚBLICA 8, COIMBRA → Praça da República 8
    3000-343 COIMBRA código postal completado · coordenadas do número de porta

Com a API

O mesmo endpoint de cada país: basta country_code. A resposta traz a morada na forma postal, o resultado com as alterações e, onde o registo está em serviço, as coordenadas, o código do município e o bairro. Tudo na documentação da API.

curl -X POST https://www.radaraddress.com/api/v1/contact \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"address":"rua augusta 100","postcode":"1100053","city":"lisboa","country_code":"PT"}'

Perguntas frequentes

Também verificam moradas que estão num ficheiro?

Sim. Nos trabalhos em bloco basta uma coluna com o país, ou o país definido para todo o ficheiro: cada linha volta na forma postal do país, com o resultado ao lado e, onde o registo está em serviço, verificada até ao número de porta.

O que acontece se uma morada não estiver no registo?

Dizemo-lo. Se a rua existe e o número não, o resultado assinala o número; se a rua não consta no município, a morada sai na mesma na forma postal do país, com o aviso. Nunca inventamos uma morada plausível no lugar da que falta.

De onde vêm os dados?

Do registo nacional de moradas, publicado como dados abertos pelo organismo cartográfico ou estatístico do país, que retomamos na licença que impõe: Fonte: Instituto Nacional de Estatística, I.P. — Base Nacional de Moradas; Câmaras Municipais de Cascais, Oeiras, Matosinhos e Nordeste (Açores); CIM Alto Tâmega e Barroso; © OpenStreetMap contributors (CC BY 4.0; ODbL). O registo é reverificado todas as noites e recarregado quando a fonte muda.

Os outros países

Itália · Alemanha · França · Espanha · Países Baixos · Bélgica · Suíça · Liechtenstein · Chéquia · Dinamarca · Noruega · Finlândia · Áustria · Eslovénia · Luxemburgo · Hungria · Roménia · Irlanda · Eslováquia · Islândia · Croácia · Andorra · Mónaco · San Marino · Cidade do Vaticano · todos os países