/
Desenha rota / Draw route

Desenha rota / Draw route

Recebe o ponto de saída e destino e desenha uma rota no mapa.

Figura 1 - Bloco Desenha rota

 

Este bloco faz parte do plugin Google Maps Api. Para visualizá-lo, é necessário instalar o plugin.

Compatibilidade

  • Bloco cliente: cronapi.maps.drawRoute()

Retorno

O bloco em si não possui retorno. No entanto, a variável de retorno "item" do bloco armazena informações sobre a rota desenhada.

Parâmetros

Id do mapa

Identificador (id) do componente Google Maps em que será desenhada a rota. Para selecioná-lo é necessário vincular o bloco de programação a um formulário de referência, confira no tópico "Propriedades do Blockly" da documentação Bloco de Programação.

  • Posição: 1

  • Inglês: Map Id

  • Tipo: Objeto / Object

  • Exemplo: "map5108"

 

O campo "Identificador" correto a ser utilizado deve seguir o padrão "map" + quatro números aleatórios (ex: map5108). Para mais detalhes, consulte o tópico "Identificador" da documentação Usando a API do Google Maps em seu projeto

Item direção da rota

Define a direção da rota. Deve-se usar a variável "item" de retorno do bloco Direção da rota.

  • Posição: 2

  • Inglês: Direction route Item

  • Tipo: Texto / String

  • Exemplo: uso do retorno do bloco Direção da rota

Opções avançadas

Define as configurações avançadas para edições na rota. Para mais detalhes, consulte a documentação oficial.

  • Posição: 3

  • Inglês: Advanced options

  • Tipo: Texto / String

  • Exemplo: "{"avoidHighways": true}"

Comandos

Comandos a serem executados sobre outros blocos de programação ou funções. 

  • Posição: 4

  • Inglês: Confirmation

  • Tipo: Comando com retorno ("item") / Command with return ("item")

  • Exemplo: uso do bloco Exibir Notificação

Exemplo

Na função da imagem abaixo, o bloco Direção da rota irá definir o cálculo da rota criada pelo bloco Criar rota, utilizando as coordenadas especificadas no bloco Criar coordenada. 

Para facilitar a visualização da rota, o bloco Desenha rota foi inserido no parâmetro "Comandos" do bloco Direção da rota para traçar visualmente o caminho do ponto de saída até o ponto de destino. No parâmetro "Opções avançadas" do bloco, inserimos um código para instruir o serviço a evitar rodovias sempre que possível. Para entender mais sobre essa propriedade, acesse o tópico "Solicitações de instruções" da documentação oficial do Google Maps.

Para exibir o mapa na aplicação precisamos inicializar o mapa, para isso, utilize o bloco de programação Inicializar Mapa. É nele que definimos os pontos iniciais de latitude e longitude. Para mais detalhes de configuração, consulte a documentação Usando a API do Google Maps em seu projeto. Após inicializar o mapa, executamos a função abaixo.

Figura 2 - Exemplo de uso do bloco Desenha rota

 

Na imagem a seguir, podemos visualizar o resultado de execução da função da Figura 2.

Figura 2.1 - Resultado de execução da função da Figura 2

Nesta página