Restringir a imagem da câmera ao vivo e os limites

Talvez você queira controlar o movimento panorâmico 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 fazer isso, use restrições de câmera.

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

Restringir limites do mapa

Para restringir os limites geográficos da câmera, defina 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

Para restringir o movimento da câmera, defina 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 os limites do mapa e da câmera

É possível restringir os limites do mapa e da câmera simultaneamente. 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();

Controlar o gerenciamento de gestos

Quando um usuário 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 gerenciamento de gestos "cooperativo" permite que o usuário role a página sem afetar o zoom ou o movimento panorâmico do mapa. Para aumentar o zoom, os usuários podem usar os controles, gestos com dois dedos (para dispositivos com tela sensível ao toque) ou manter CMD/CTRL pressionado enquanto rolam.

O código a seguir demonstra como definir o gerenciamento 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 gerenciamento de gestos "greedy" reage a todos os eventos de rolagem e gestos de toque.

gestureHandling: auto

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

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