/
Desenha polígono / Draw Polygon

Desenha polígono / Draw Polygon

Função que desenha um polígono no mapa.

Figura 1 - Bloco Desenha polígono

 

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

Compatibilidade

  • Bloco cliente: cronapi.maps.drawPolygon()

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 do polígono

Identificador da polilinha (definido pelo usuário).

  • Posição: 2

  • Inglês: Polygon id

  • Tipo: Texto / String

  • Exemplo: "IdPoligono"

Lista de coordenadas

Lista de coordenadas necessárias para desenhar o polígono no mapa.

Cor de preenchimento

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

  • Posição: 5

  • Inglês: Fill color

  • Tipo: Texto / String

  • Exemplo: "yellow" ou "#FFFF00"

Opacidade do preenchimento

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

  • Posição: 6

  • Inglês: Opacity of filling

  • Tipo: Texto / String

  • Exemplo: "0.5"

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: 7

  • 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: 8

  • 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: 9

  • Inglês: Advanced options

  • Tipo: Objeto / Object

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

Exemplo

O exemplo da figura abaixo desenha um polígono ligando quatro estados brasileiros, a lista de coordenadas é passada através do bloco Criar lista com, acompanhado do bloco Criar coordenada. Em Opções avançadas, inserimos o código abaixo para liberar uma interação de arrastar pontos no mapa, como na figura 2.1.

{"editable": true}

Figura 2 - Exemplo de uso do bloco Desenha polígono

 

O primeiro botão exibido na figura abaixo corresponde à função Inicializar Mapa. Ele deve ser acionado antes de ativar o botão "Desenhar Polígono", 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 
e demonstração do arrastar referente à opção avançada

 

Coordenadas utilizadas no exemplo

Coordenadas 
    Latitude :-3.7722775
    Longitude: -38.5592914

Coordenadas
    Latitude :-12.8845715
    Longitude: -38.2853121

Coordenadas
    Latitude: -15.721387
    Longitude: -48.0774442

Coordenadas
    Latitude: -5.3373634
    Longitude: -49.1710494

Coordenadas
    Latitude: -3.7722775
    Longitude: -38.5592914

Nesta página