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, elenã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), 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.
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
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çãoUsando a API do Google Maps em seu projetocomo 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.
Para que a função funcione, primeiroprecisamos inicializar o mapa, para isso, utilize o bloco de programaçãoInicializar Mapa. É nele que definimos os pontos iniciais de latitude e longitude.