Como é gerada a coordenada geográfica dos locais?

1. O que é e como funciona?

A coordenada geográfica é gerada com base nas informações do endereço cadastrado no local. Ela serve para promover o serviço de geolocalização e possibilitar cálculos de distância em relação ao local utilizado. Quanto mais completo for o endereço de um local, maior será a precisão da sua coordenada.

2. Quando uso?

Além de ter acesso à geolocalização de um local cadastrado no ambiente, pode-se utilizar a coordenada geográfica para realizar cálculos de distância no aplicativo, como por exemplo:

- Identificar distância percorrida do usuário até o local de execução da tarefa.

- Impedir que o usuário realize uma tarefa sem estar dentro de um raio de distância do local de execução.

3. Como configurar?

Aqui está o detalhamento da chamada feita para os serviços de geolocalização, de acordo com as configurações do provedor:

1) Quando temos todas as informações do endereço, enviamos tudo. Exemplo:

{país, estado, cidade, CEP, bairro, tipo logradouro, logradouro, número}

- Nesse caso, tudo é enviado para o provedor de geolocalização.

2) Quando não temos algum dos dados do endereço, enviamos os dados informados. Segue abaixo exemplo sem ter bairro e tipo logradouro preenchido:

{país, estado, cidade, CEP, logradouro, número}

- Nesse caso, pulamos os dados não encontrados e seguimos enviando o resto.

Qual é o mínimo de dados do endereço que devem ser preenchidos?

Temos configurado um mínimo de dados para serem enviados ao provedor de geolocalização:

- Só tendo o CEP preenchido, enviamos para o provedor apenas o CEP.

- Não tendo o CEP, temos que ter pelo menos os campos: estado, cidade e logradouro com valor.

- Não tendo o CEP e não tendo estado, cidade e logradouro, não enviamos nada e retornamos erro para o usuário.

Resumo da regra:

O mínimo que precisamos para chamar o provedor de geolocalização é:

- CEP;

- Estado, cidade e logradouro, se não tiver CEP.

Ou seja, o CEP é o dado principal enviado ao provedor de geolocalização. Se o CEP estiver correto, não há necessidade de informar o bairro.