Desenha Retângulo / Draw Rectangle
Função que desenha uma área retangular no mapa.
Figura 1 - Bloco Desenha Retângulo
Este bloco faz parte do plugin Google Maps Api. Para visualizá-lo, é necessário instalar o plugin.
Compatibilidade
Bloco cliente: cronapi.maps.drawRectangle()
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 retângulo
Identificador do retângulo (definido pelo usuário).
Posição: 2
Inglês: Rectangle id
Tipo: Texto / String
Exemplo: "IdRetangulo"
Limites
Define os pontos externos de uma área. Os pontos são definidos a partir de atributos (em inglês) de um objeto no formato JSON, são eles: north, south, east, west. É necessário utilizar o bloco Criar objeto.
Posição: 3
Inglês: Bounds
Tipo: Objeto / Object
Exemplo: uso do bloco Criar objeto com as coordenadas dispostas no formato chave/valor:
{"north": 33.685, "south": 33.671, "east": -116.234, "west": -116.251}
Cor do preenchimento
Define a cor do contorno do retângulo, podem ser nomeadas pelo nome (em inglês) ou no formato hexadecimal.
Posição: 4
Inglês: Fill color
Tipo: Texto / String
Exemplo: "yellow" ou "#FFFF00"
Cor do contorno
Define a cor do contorno do retângulo, podem ser nomeadas pelo nome (em inglês) ou no formato hexadecimal.
Posição: 5
Inglês: Stroke color
Tipo: Texto / String
Exemplo: "yellow" ou "#FFFF00"
Opacidade do preenchimento
Define a opacidade referente à cor de preenchimento, indo de 0 à 1.
Posição: 6
Inglês: Opacity of filling
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: 7
Inglês: Advanced options
Tipo: Objeto / Object
Exemplo: "
{"visible": true}"
Exemplo
No exemplo da figura abaixo, estamos delimitando uma área estabelecida no parâmetro Limites do bloco de programação Desenha retângulo. Utilizamos o bloco Criar objeto para selecionar a área que será demarcada.
Figura 2 - Exemplo de uso do bloco Desenha retângulo
O primeiro botão mostrado na figura abaixo corresponde à função Inicializar Mapa. Ele deve ser acionado antes de ativar o botão "Desenhar Retângulo", caso contrário, o mapa não será exibido.
Figura 2.1 - Resultado da execução da função da figura 2
Coordenadas utilizadas no bloco Inicializar Mapa
Latitude: 33.685199929186524
Longitude: -116.23915885220599
Coordenadas utilizadas no parâmetro Limites
{"north": 33.685, "south": 33.671, "east": -116.234, "west": -116.251}
Nesta página