Controlar o mapa e a câmera

Selecione a plataforma: Android iOS JavaScript

Pode ser interessante controlar o movimento horizontal e a altitude máxima da câmera ou criar limites de latitude e longitude para restringir o movimento de um usuário em um determinado mapa. Para isso, use as restrições de câmera.

O exemplo a seguir mostra um mapa com limites de local definidos para restringir o movimento da câmera:

Restringir limites do mapa

É possível restringir os limites geográficos da câmera definindo a opção bounds.

O exemplo de código a seguir demonstra como restringir os limites do mapa:

async function init() {
  const { Map3DElement, MapMode } = await google.maps.importLibrary("maps3d");

  const map = new Map3DElement({
    center: { lat: 37.7704, lng: -122.3985, altitude: 500 },
    tilt: 67.5,
    mode: MapMode.HYBRID,
    bounds: {south: 37, west: -123, north: 38, east: -121}
  });

init();
}

Restringir a câmera

Você pode restringir o movimento da câmera definindo uma das seguintes opções:

• maxAltitude
• minAltitude
• maxHeading
• minHeading
• maxTilt
• minTilt

O exemplo de código a seguir demonstra como restringir a câmera:

async function init() {
  const { Map3DElement, MapMode } = await google.maps.importLibrary("maps3d");

  const map = new Map3DElement({
    center: { lat: 37.7704, lng: -122.3985, altitude: 500 },
    tilt: 67.5,
    mode: MapMode.HYBRID,
    minAltitude: 1,
    maxAltitude: 1000,
    minTilt: 35,
    maxTilt: 55
  });

 document.body.append(map);
}

init();

Restringir limites do mapa e da câmera

É possível restringir simultaneamente os limites do mapa e da câmera. O exemplo de código a seguir demonstra como restringir os limites do mapa e da câmera:

async function init() {
  const { Map3DElement, MapMode } = await google.maps.importLibrary("maps3d");

  const map = new Map3DElement({
    center: { lat: 37.7704, lng: -122.3985, altitude: 500 },
    tilt: 67.5,
    mode: MapMode.HYBRID,
    minAltitude: 1,
    maxAltitude: 1000,
    minTilt: 35,
    maxTilt: 55,
    bounds: {south: 37, west: -123, north: 38, east: -121}
  });

 document.body.append(map);
}

init();

Caminhos de câmera predefinidos

Os mapas 3D no JavaScript do Maps oferecem dois caminhos de câmera predefinidos. Os trajetos da câmera podem ser personalizados mudando a duração da animação (aumentando ou diminuindo a velocidade) ou combinando-os para criar experiências mais cinematográficas.

Os mapas 3D no JavaScript do Maps são compatíveis com os seguintes caminhos de câmera:

• A animação flyCameraTo voa do centro do mapa para um destino especificado.
• A animação flyCameraAround gira em torno de um ponto no mapa o número especificado de revoluções.

Os dois caminhos disponíveis podem ser combinados para voar até um ponto de interesse, girar em torno dele e parar quando especificado.

Voar para

O exemplo de código a seguir demonstra como animar a câmera para voar até um local:

const map = document.querySelector('gmp-map-3d');

async function init() {
  await google.maps.importLibrary('maps3d');

  map.flyCameraTo({
    endCamera: {
      center: { lat: 37.6191, lng: -122.3816 },
      tilt: 67.5,
      range: 1000
    },
    durationMillis: 5000
  });
}

Voar por aí

O exemplo de código a seguir demonstra como animar a câmera para voar ao redor de um local:

const map = document.querySelector('gmp-map-3d');

async function init() {
  await google.maps.importLibrary('maps3d');

  map.flyCameraAround({
    camera,
    durationMillis: 60000,
    repeatCount: 1
  });
}

Combinar animações

O exemplo de código a seguir demonstra a combinação de animações para mover a câmera até um local e girar ao redor dele quando a primeira animação termina:

const map = document.querySelector('gmp-map-3d');

async function init() {
  await google.maps.importLibrary('maps3d');

  map.flyCameraTo({
    endCamera: flyToCamera,
    durationMillis: 5000,
  });

  map.addEventListener('gmp-animationend', () => {
    map.flyCameraAround({
      camera: flyToCamera,
      durationMillis: 60000,
      repeatCount: 1
    });
  }, {once: true});
}

Controlar o gerenciamento de gestos

Quando uma pessoa rola uma página que contém um mapa, isso pode aumentar o zoom sem querer. Para controlar esse comportamento, defina a opção de mapa gestureHandling.

gestureHandling: cooperative

O processamento de gestos "cooperativo" permite que o usuário role a página sem afetar o zoom ou o movimento do mapa. Para aumentar o zoom, os usuários podem usar os controles, gestos com dois dedos (para dispositivos com tela touch) ou manter pressionado CMD/CTRL enquanto rolam a tela.

O código a seguir demonstra a configuração do processamento de gestos como "cooperativo":

new Map3DElement({
  center: { lat: 37.729901343702736, lng: -119.63788444355905, altitude: 1500 },
  tilt: 70,
  heading: 50,
  range: 4000,
  gestureHandling: 'COOPERATIVE',
});

gestureHandling: greedy

O processamento de gestos "greedy" reage a todos os eventos de rolagem e gestos de toque.

gestureHandling: auto

O processamento de gestos "Automático" muda o comportamento do mapa dependendo de se ele está ou não contido em um <iframe> e se a página pode ser rolada.

• Se o mapa estiver em um <iframe>, o processamento de gestos será "cooperativo".
• Se o mapa não estiver em um <iframe>, o processamento de gestos será "greedy".