Criar rota / Creates route
Cria a requisição de uma rota para o bloco Direção da rota.
Figura 1 - Bloco Criar rota
Este bloco faz parte do plugin Google Maps Api. Para visualizá-lo, é necessário instalar o plugin.
Compatibilidade
Bloco cliente: cronapi.maps.createRequestDirection()
Retorno
Retorna um objeto com os valores necessários para o cálculo da rota do bloco Direção da rota.
Parâmetros
Ponto de origem
Define o ponto de origem da rota. Deve-se utilizar o retorno do bloco Criar coordenada.
Posição: 1
Inglês: Origin point
Tipo: Objeto / Object
Exemplo: uso do retorno do bloco Criar coordenada
Ponto de destino
Define o ponto de destino da rota. Deve-se utilizar o retorno do bloco Criar coordenada.
Posição: 2
Inglês: Destination point
Tipo: Objeto / Object
Exemplo: uso do retorno do bloco Criar coordenada
Modo da viagem
Define o meio de locomoção utilizado na viagem.
Posição: 3
Inglês: Travel mode
Tipo: Objeto / Object
Exemplo: "Carro"
Opções:
Carro: a rota será definida com base em uma viagem de carro.
Transporte público: a rota será definida com base em uma viagem de transporte público.
A pé: a rota será definida com base em uma viagem a pé.
Bicicleta: a rota será definida com base em uma viagem de bicicleta.
Opções avançadas
Recebe um objeto com as opções avançadas correspondentes ao modo de viagem selecionado. Para utilizar corretamente esses parâmetros, recomenda-se a consulta à documentação oficial.
Posição: 4
Inglês: Advanced options
Tipo: Texto / String
Exemplo: "
{"avoidFerries": true}"
Exemplo
Na função da imagem abaixo, o bloco Criar rota, utilizando as coordenadas definidas no bloco Criar coordenada, irá retornar os valores necessários para o cálculo da rota do bloco Direção da rota. 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 facilitar a visualização do resultado da obtenção das coordenadas pelo bloco Criar rota, inserimos o bloco Desenha rota no parâmetro "Comandos" do bloco Direção da rota. Esse bloco é responsável por traçar o caminho do ponto de saída até o ponto de destino.
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 Criar 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