A geocodificação ou geocoding é o processo computacional que transforma uma morada numa localização na superfície da Terra, utilizando coordenadas geográficas.
O Forward geocoding onverte o texto da localização em coordenadas geográficas, por exemplo,
Asseguro que se colocar
"R. Ramalho Ortigão 2, 2790-307 Queijas, Portugal" tornar-se-é em:
"latitude": 38.718587,
"longitude": 9.261517
1. Enviar o código postal completo correcto
Os códigos postais em Portugal são compostos por uma parte numérica e por designação postal (o nome de uma localidade).
- A parte número tem 7 algarismos, sendo que os 4 primeiros são sempre separados dos últimos 3 por um hífen (por exemplo, 2790-307 Queijas)
- A designação postal é o nome de uma localidade: nome da cidade ou da freguesia consoante a localização.
É obrigatório a utilização dos 7 algarismos do código postal para que a nossa API identifique corretamente a localidade de entrega, pois pode existir o mesmo nome de rua nas várias localidades de um mesmo concelho, exemplo
"2790-307" → corresponde a "Queija".
"2790-123" → corresponde a "Carnaxide".
No seguinte link poderá encontrar o motor de busca do site web dos CTT onde poderá verificar os códigos postais. Registando-se no site, poderá transferir um ficheiro csv com todos os códigos postais de Portugal, com a localidade correspondente.
2. Recolher moradas com campos de preenchimento automático
Recomendamos o uso de uma solução de pesquisa de moradas, como o Google Autocomplete, para os seus campos de recolha de moradas. Irá minimizar os erros humanos e melhorar a formatação de moradas. Abaixo um exemplo de como funciona:
3. Validar moradas via a API Stuart
O ponto final de Job Validation pode ser utilizado para garantir que as suas moradas serão aceites durante a criação do pedido (“job creation”). Este parâmetro verifica se a morada pode ser geocodificada com um nível adequado de precisão e se está dentro da área de entrega Stuart.
O ponto final do parâmetro Job Validation é útil para validar de uma só vez que ambas as moradas de recolha e de entrega são válidas. Para além de validarmos as moradas, também validamos que toda a carga do trabalho seria aceite, consulte avoiding common job creation errors para mais informações.
Note que moradas aproximadas (approximate addresses) exigirão um número de telefone válido para serem aceites. De facto, aconselhamos sempre a fornecer um número de telefone válido para melhorar a taxa de sucesso das suas entregas.
4. Omitir detalhes adicionais da morada
O processo de geocodificação é complicado, e embora em constante melhoria, não é sem os seus problemas. Pode acontecer que a morada geocodificada encontrada numa resposta de “job creation” Stuart, não corresponde à morada original que forneceu.
Para evitar problemas de alteração de moradas, aconselhamos omitir quaisquer detalhes adicionais da morada no campo da morada. Em alternativa, poderá sempre colocar esta informação no campo dos comentários ao criar o pedido (creating a job). Alguns exemplos a não replicar:
- Número do apartamento, especificação do andar e lugares que são complementares aos dados da rua principal: “Nº2, 2º esquerdo”.
- Gamas de números de rua, por exemplo, “12 - 14”.
- Nomes de proprietários, por exemplo “Sr. Smith”.
Se tiver dificuldades em separar tais informações das moradas, ou se continuar a enfrentar estes problemas de descoordenação de moradas, poderá considerar algumas opções de nova tentativa. Por exemplo, se a morada na resposta de “job creation” for diferente da original, poderá cancelar e tentar novamente com uma morada modificada.
5. Acrescentar o número do edifício e/ou nome do restaurante/loja
Apenas os códigos postais ou números de ruas não são suficientes. À medida que geocodificamos o campo da morada, transformamos o endereço em latitude e longitude geocodificada. Se tivermos apenas o código postal ou o nome da rua, não podemos enviar o parceiro de entrega para um local exato.Por favor acrescente sempre o número do edifício ou pelo menos o nome da rua e o nome do restaurante.
Por exemplo:
"Mano a Mano, R. do Alecrim 22, 1200-161 Lisboa" ou "BOA-BAO, Largo Rafael Bordalo Pinheiro 30, 1200-369 Lisboa.