Perguntas · Moradas

Como obtenho as coordenadas de uma morada portuguesa?

Porque primeiro se normaliza e só depois se geocodifica

Um serviço de geocodificação responde sempre com um ponto, mesmo a uma morada errada: pega na rua que mais se parece e põe-lhe um pontinho em cima. Se a morada tinha o código postal de outra localidade ou a rua abreviada de forma ambígua, o ponto é convincente e errado, e ninguém dá por isso até a transportadora telefonar.

A RadarAddress faz o contrário: primeiro a verificação da morada, que resolve localidade, rua e número com os mesmos resultados declarados da normalização, depois a procura das coordenadas sobre a morada já corrigida. Se a rua não consta na localidade, não há nenhum ponto: o resultado diz que a morada deve ser revista, e a coordenada fica vazia em vez de ser inventada.

Os níveis de precisão, sempre declarados

As coordenadas saem com um campo que diz a que nível foram encontradas:

• número de porta: o ponto do próprio número, tal como o registo nacional o tem.
• interpolado: o número exato não está georreferenciado, e o ponto é estimado a partir dos números vizinhos. Serve para um mapa ou para calcular distâncias, não para uma entrega ao metro.
• rua: só o centro da rua, quando dos números não se sabe nada.
• localidade: só o centro da localidade. É o último recurso, útil para agrupar, não para localizar.

Em Portugal o registo nacional é feito de alojamentos: as ruas comerciais e os centros das cidades estão lá, mas há troços e edifícios sem habitações que faltam, e a cobertura muda de município para município. Por isso o nível está escrito ao lado de cada ponto e não há um número único de cobertura a prometer: olha para o campo e decide o que fazer com ele.

Junto com as coordenadas: o município

Com a morada resolvida sai também o código do município tal como o registo nacional o identifica, estável mesmo quando o nome muda de grafia, e a localidade na forma oficial. São dados que no seu ficheiro não estavam e que permitem, por exemplo, contar os clientes por concelho com uma junção de tabelas em vez de uma pesquisa por texto, onde «Vila Nova de Gaia», «V. N. de Gaia» e «Gaia» contam como três sítios.

Para que serve georreferenciar uma base de contactos

As coordenadas transformam uma base de moradas num mapa sobre o qual se pode raciocinar. Os usos mais comuns:

• Atribuir os contactos a um território. Cada ficha cai na zona de um vendedor, de uma delegação, de um voluntário ou de um núcleo, por proximidade real e não pelo código postal, que nas cidades grandes corta os bairros ao meio.
• Calcular distâncias. A quantos quilómetros fica cada cliente da loja mais próxima, quantos apoiantes moram a menos de dez quilómetros do local do evento, que moradas convém agrupar numa volta de entregas.
• Ver onde estão os clientes. Um mapa dos doadores, das encomendas ou dos sócios mostra num relance onde o trabalho rende e onde falta, melhor do que uma tabela por distrito.
• Cruzar dados externos. Com o município resolvido na forma oficial ligam-se população, densidade e as estatísticas públicas por concelho, sem passar pelo nome escrito à mão.
• Reconhecer as moradas vizinhas. Duas fichas com ruas diferentes e o mesmo ponto no mapa merecem uma vista de olhos: acontece com as ruas renomeadas e com as entradas duplas do mesmo edifício.

Em todos estes casos o nível de precisão conta: para atribuir um território basta a localidade, para uma volta de entregas é preciso o número de porta. Por isso sai sempre escrito ao lado do ponto.

Onde as encontra: site, ficheiro, API

Na verificação a partir do site, quando a morada é resolvida, as coordenadas aparecem com o seu nível. Num trabalho a partir de ficheiro, as colunas da latitude, da longitude e da precisão juntam-se ao resultado em cada linha, ao lado do código do município: a geocodificação em lote de uma base inteira é o mesmo trabalho da verificação, não um serviço à parte. Na API o endpoint /api/v1/contact devolve o objeto geo com latitude, longitude, precisão e fonte, e o objeto territory com os códigos; a documentação indica os campos e a atribuição devida quando a fonte são dados cartográficos abertos.

O preço é o da verificação da morada: as coordenadas e os códigos fazem parte do resultado. Os preços estão na página de preços.

Uma morada, o ponto e o seu nível

O código postal, que faltava, foi posto pelo registo a partir da rua e do número; a rua passou de maiúsculas à forma do registo. O número 8 está georreferenciado no registo nacional: o ponto é o do próprio número, e o campo da precisão di-lo.