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
Nesta página
- 1 Compatibilidade
- 2 Retorno
- 3 Parâmetros
- 3.1 ID do mapa
- 3.2 Latitude
- 3.3 Longitude
- 4 Exemplo