Obter Geocodificação
Função que obtém todas as características de uma localização.
Parâmetros de Entrada
Nome | Nome | Tipo | Doc |
|---|---|---|---|
| Parâmetro 1 | Requisição do Endereço | Objeto | Parâmetro obrigatório, define o endereço do local que se deseja obter a geocodificação. |
| Parâmetro 2 | Limites | Objeto | Parâmetro opcional, define os limites de busca do endereço, ele não restringe totalmente (apenas influencia) os resultados do geocodificador, é necessário utilizar o bloco de programação Pontos do retângulo e Criar coordenada. |
| Parâmetro 3 | Opções avançadas | Objeto | Parâmetro opcional, pode receber tanto parâmetros obrigatórios quanto parâmetros opcionais. Confira o tópico Opções avançadas para mais informações. |
| Parâmetro 4 | Comandos | Envio de Comandos | Adiciona novos blocos de programação. |
Compatibilidade
Cliente
Exemplo
Existem várias maneiras de utilizar o bloco de programação Obter Geocodificação e isso se deve ao fato de haver parâmetro(s) obrigatório(s) e opcional(is)parâmetros obrigatórios e opcionais, este bloco apresenta somente um parâmetro obrigatório e um opcional, porém o parâmetro "Opções avançadas" pode utilizar tanto um quanto o outro. . A documentação oficial nos apresenta outros tipos de parâmetros obrigatórios e opcionais que podemos utilizar.
No exemplo da figura abaixo, a função busca os dados de geocodificação do endereço passado no parâmetro 1. No segundo parâmetro, Limites, definimos o limite do ponto até onde queremos geocodificar, esse parâmetro sempre recebe o bloco de programação Pontos do retângulo seguido pelo bloco Criar coordenada.
Figura 1 - Bloco de programação Obter Geocodificação
Nos exemplo da figura 1, estamos passando um parâmetro obrigatório (parâmetro 1) e um opcional (parâmetro 2). Porém, também é possível utilizar o bloco somente com um parâmetro obrigatório, confira na figura 2.
Figura 2 - Bloco de programação Obter Geocodificação utilizando somente o parâmetro obrigatório
Existem 3 formas de utilização do parâmetro "Opções avançadas", a primeira é passando somente o parâmetro obrigatório, e dessa foram não devemos informar o parâmetro 1. A segunda, exemplo da figura 3, é passar um parâmetro opcional, e dessa forma devemos informar o parâmetro 1 e a ultima forma é passar o parâmetro obrigatório e um opcional, como mostra a figura 4
Figura 3 - Bloco de programação Obter Geocodificação utilizando Opções avançadas
Também é possível passar os dados todos de uma vez no parâmetro "Opções avançada", lembrando sempre que a requisição tem que ser feita no formato JSON. Na figura 4 passamos o parâmetro "address" e "region", o parâmetro obrigatório "address" corresponde ao parâmetro "Requisição do Endereço".
A figura 2 apresenta o resultado da execução da função da figura 1. O resultado é apresentado na forma de um JSON, para entender mais sobre o que significa cada parâmetro apresentado na imagem, confira na documentação oficial.
Sobre o Bloco
Este é um bloco do tipo Google Maps, antes de utilizá-lo é necessário fazer a instalação do plugin do Google Maps, confira na documentação Usando a API do Google Maps em seu projeto como instalá-lo. O bloco Obter Geocodificação possui parâmetros obrigatórios e opcionais, verifique o tópico Situações do Geocoding da documentação oficial para mais informações.
| Informações |
|---|
Para que a função funcione, primeiro precisamos inicializar o mapa, para isso, utilize o bloco de programação Inicializar Mapa. É nele que definimos os pontos iniciais de latitude e longitude. |