Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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 ele não restringe totalmente (apenas influencia) os resultados do geocodificador, é necessário utilizar o bloco os blocos de programação Pontos do retângulo e Criar coordenada. |
Parâmetro 3 | Opções avançadas | Objeto | Parâmetro opcional, pode receber tanto Espera receber um objeto JSON com parâmetros obrigatórios quanto parâmetros opcionais. Confira o tópico Opções avançadas para mais informações, opcionais ou ambos. Veja mais detalhes na documentação oficial.
|
Parâmetro 4 | Comandos | Envio de Comandos | Adiciona novos blocos de programação que serão utilizados junto com o retorno do bloco. |
Retorno
Retorna um objeto JSON contendo as propriedades geocodificadas.
Compatibilidade
Image Modified Cliente
Exemplo 1
Existem várias maneiras de utilizar o bloco de programação Obter Geocodificação e isso se deve ao fato de haver parâmetros obrigatórios e opcionais, este . Este bloco apresenta somente um parâmetro obrigatório (Requisição do Endereço) e um opcional (Limites), porém já o parâmetro "Opções avançadas" pode utilizar ser tanto um quanto o outroobrigatório quanto opcional, isso dependerá dos atributos utilizados do objeto JSON. Não é permitido informar 2 parâmetros obrigatório ao mesmo tempo. A documentação oficial nos nos apresenta outros tipos de parâmetros obrigatórios e opcionais que podemos utilizar.
Apesar das configurações diferentes nas figuras 1, 2, 3 e 4, ao executar, todas exibirão o mesmo resultado (Figura 5).
No exemplo da figura abaixo, a função busca os dados de geocodificação do endereço passado no parâmetro 1 (Requisição do Endereço). 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 de blocos Criar coordenada.
Image Modified
Figura 1 - Bloco de programação Obter Geocodificação
Nos No 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, informamos o endereço sem delimitar uma área de busca.
Image Modified
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 :
- Incluir um atributo JSON obrigatório no objeto e não informar o parâmetro 1
- (Requisição do Endereço), já que não são aceitos 2 parâmetros obrigatórios (ver problema com 2 parâmetros obrigatórios no tópico Exemplo 2).
- Incluir um atributo JSON opcional e informar o parâmetro 1 (Requisição do Endereço), já que é necessário pelo menos 1 parâmetro obrigatório (figura 3).
- Preencher apenas o parâmetro Opções avançadas com o objeto JSON do objeto contendo 1 atributo obrigatório e 1 ou mais opcionais (figura 4).
Image Modified
Figura 3 - Bloco de programação Obter Geocodificação utilizando Opções avançadas com parâmetro opcional
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" (parâmetro JSON obrigatório) e "region" (parâmetro JSON opcional) , o parâmetro obrigatório "address" corresponde ao parâmetro "Requisição do Endereço".
Image Modified
Figura 4 - Bloco de programação Obter Geocodificação utilizando Opções avançadas com os dois tipos de parâmetros
O usuário pode configurar a função da forma que foi apresentada nas figuras 1,2,3 ou 4 ao executar, todas apresentarão o mesmo resultado (figura 5). O retorno estará em formato 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.
Image Modified
Figura 5 - Resultado da execução das funções anteriores
Âncora exemplo2 exemplo2
Exemplo 2
Não é possível utilizar dois parâmetros obrigatórios ao mesmo tempo, no exemplo da figura 6 estamos informando o endereço da requisição no parâmetro 1 e, em seguida, passamos outro parâmetro JSON obrigatório, o placeId
.
Image Added
Figura 6 - Bloco Obter Geocodificação com dois parâmetros obrigatórios
A figura 7 exibe o erro gerado a partir da figura 6.
Image Added
Figura 7 - Erro ao utilizar 2 parâmetros obrigatórios
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 é necessário ter a Geocoding API instalada no seu projeto, mas antes disso precisamos inicializar o mapa, para isso, utilize o bloco de programação Inicializar Mapa. É nele que definimos os pontos iniciais de latitude e longitude. |