Centralizar o mapa / Center the map

Centralizar o mapa / Center the map

Função que centraliza o mapa com base nas coordenadas informadas.

Figura 1 - Bloco Centralizar o mapa

 

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

Compatibilidade

  • Bloco cliente: cronapi.maps.centralizeMap()

Retorno

O bloco não possui retorno.

Parâmetros

ID do mapa

Identificador (id) do componente Google Maps que terá suas coordenadas centralizadas. 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

Latitude

Recebe a latitude da coordenada a ser centralizada no mapa.

  • Posição: 2

  • Inglês: Latitude

  • Tipo: Texto / String

  • Exemplo: "-12.967852158398456"

Longitude

Recebe a longitude a ser centralizada no mapa.

  • Posição: 3

  • Inglês: Longitude

  • Tipo: Texto / String

  • Exemplo: "-38.4917247878949"

Exemplo

Na função da imagem abaixo, o bloco Centralizar o mapa irá centralizar a exibição de um componente Google Maps de acordo com as coordenadas dos parâmetros "Latitude" e "Longitude".

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 obter o resultado semelhante ao da Figura 2.1, configure o parâmetro "Zoom" do bloco como "Cidade". 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 Centralizar o mapa

 

Na imagem a seguir, podemos visualizar o resultado de execução da função da Figura 2. Observe que o mapa foi centralizado de acordo com as coordenadas informadas no bloco referentes a cidade de São Paulo.

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