/
Desenha Linha / Drawn Line

Desenha Linha / Drawn Line

Função que desenha uma linha no mapa.

Figura 1 - Bloco Desenha linha

 

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

Compatibilidade

  • Bloco cliente: cronapi.maps.drawLine()

Retorno

O bloco não possui retorno.

Parâmetros

ID do mapa

Identificador (id) do componente Google Maps. 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

Identificador da polilinha

Identificador da polilinha (definido pelo usuário).

  • Posição: 2

  • Inglês: Polyline id

  • Tipo: Texto / String

  • Exemplo: "IdLinha"

Lista de coordenadas

Lista de coordenadas necessárias para desenhar a linha no mapa.

Cor do contorno

Define a cor do contorno do círculo, podem ser nomeadas pelo nome (em inglês) ou no formato hexadecimal.

  • Posição: 4

  • Inglês: Stroke color

  • Tipo: Texto / String

  • Exemplo: "yellow" ou "#FFFF00"

Opacidade do contorno

Define a opacidade referente à cor do preenchimento, indo de 0 à 1.

  • Posição: 5

  • Inglês:  Stroke opacity

  • Tipo: Texto / String

  • Exemplo: "0.5"

Opções avançadas

Recebe um objeto contendo opções de customização no polígono. Acesse a documentação oficial para mais detalhes.

  • Posição: 6

  • Inglês: Advanced options

  • Tipo: Objeto / Object

  • Exemplo: "{"editable": true}"

Exemplo

No exemplo da figura abaixo, estamos simulando um tráfego aéreo de um voo do Brasil até os Estados Unidos, fazendo escala na Venezuela e México. No parâmetro "Opções avançada" do bloco Desenha linha, inserimos o código abaixo para liberar uma interação de arrastar pontos no mapa. A opção deverá ser passada em formato JSON:

Opções avançadas do bloco Desenha linha
{"editable": true}

Figura 2 - Exemplo de uso do bloco Desenha linha

 

O primeiro botão mostrado na figura abaixo corresponde à função Inicializar Mapa. Ele deve ser acionado antes de ativar o botão "Desenhar Linha", caso contrário, o mapa não será exibido.

Figura 2.1 - Retorno no mapa após a execução da função referente à figura 2

 

Coordenadas Utilizadas no Exemplo

 

Coordenadas Brasil:
    Latitude: -8.378841019583016
    Longitude:  -56.21177530938497


Coordenadas Venezuela:
     Latitude: 6.879995144419558 
     Longitude: -65.52796396851399


Coordenadas México:
     Latitude: 23.923430031877146
     Longitude: -102.09046311091437


Coordenadas EUA:
     Latitude: 40.87815794986896 
     Longitude: -101.7389006191605

 

Nesta página