Automatycznie dopasowuj widok kamery do elementów mapy

Możesz automatycznie kadrować znaczniki, linie łamane, wielokąty i trasy 3D w widocznym obszarze <gmp-map-3d>, ustawiając atrybut HTML autofits-camera lub właściwość autofitsCamera w obsługiwanych elementach podrzędnych. Gdy co najmniej 1 element podrzędny akceptuje, mapa oblicza pozycję kamery, która utrzymuje wszystkie zaakceptowane elementy w widoku.

Automatyczne dopasowywanie kamery jest dostępne w kanale v=beta interfejsu Maps JavaScript API. Instrukcje dotyczące wczytywania wersji beta znajdziesz w sekcji Wersje.

Obsługiwane elementy

W tabeli poniżej znajdziesz listę elementów podrzędnych Map3DElement, które obsługują autofits-camera (autofitsCamera):

Element HTML Klasa JavaScript Biblioteka Uwagi
<gmp-marker-3d>, <gmp-marker-3d-interactive> Marker3DElement, Marker3DInteractiveElement maps3d Ustawia kadr na position znacznika.
<gmp-marker>, <gmp-marker-interactive> MarkerElement, MarkerInteractiveElement maps3d Ustawia kadr na position znacznika.
<gmp-polyline-3d>, <gmp-polyline-3d-interactive> Polyline3DElement, Polyline3DInteractiveElement maps3d Obejmuje wszystkie współrzędne w obiekcie path linii łamanej.
<gmp-polygon-3d>, <gmp-polygon-3d-interactive> Polygon3DElement, Polygon3DInteractiveElement maps3d Obejmuje wszystkie współrzędne w elemencie path wielokąta.
<gmp-route-3d> Route3DElement routes Czeka na rozwiązanie żądania trasy, a następnie kadruje ścieżkę trasy.

Nieobsługiwane elementy

Model3DElement, PopoverElement i FlattenerElement nie obsługują autofitsCamera. Aby wykadrować te elementy, ustaw center i range na <gmp-map-3d> lub wywołaj flyCameraTo.

Dopasuj kamerę przy początkowym wczytywaniu

Aby wykadrować elementy podczas wczytywania mapy, dodaj atrybut autofits-camera do każdego elementu podrzędnego, który ma się znaleźć w początkowym widocznym obszarze. Nie musisz obliczać center ani range w <gmp-map-3d>:

<gmp-map-3d
  style="height: 400px; width: 100%;"
  mode="hybrid">
  <gmp-marker-3d
    position="47.6205,-122.3493"
    title="Space Needle"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-marker-3d
    position="47.6097,-122.3425"
    title="Pike Place Market"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-polyline-3d
    path="47.6205,-122.3493,0 47.6097,-122.3425,0"
    stroke-color="#4285F4"
    stroke-width="8"
    altitude-mode="clamp-to-ground"
    autofits-camera>
  </gmp-polyline-3d>
</gmp-map-3d>

<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d">
</script>

Zastąp YOUR_API_KEY kluczem interfejsu API Google Maps Platform.

Dopasowywanie i animowanie aktualizacji dynamicznych

Gdy po początkowym wczytaniu dodasz element, który został uwzględniony, zaktualizujesz jego współrzędne lub punkty końcowe trasy albo ustawisz autofitsCamera na true, mapa ponownie obliczy pozycję kamery, aby objąć wszystkie uwzględnione elementy. Usunięcie elementu lub ustawienie autofitsCamera na false pozostawia kamerę w jej pozycji i wyklucza ten element z przyszłych aktualizacji.

Aby określić, czy aktualizacje dynamiczne mają być przyciągane czy animowane, ustaw właściwość autofitsCameraAnimation (autofits-camera-animation) w Map3DElement na wartość AutofitsCameraAnimation:

  • AutofitsCameraAnimation.NONE ("none", domyślna): przyciąga do zaktualizowanej pozycji bez animacji.
  • AutofitsCameraAnimation.FLY_TO ("fly-to"): płynnie przelatuje do zaktualizowanej pozycji. Początkowe wczytywanie mapy odbywa się bez animacji, a FLY_TO powraca do tego stanu, gdy system operacyjny użytkownika żąda ograniczenia ruchu.

Aby skonfigurować autofitsCamera i AutofitsCameraAnimation.FLY_TO automatycznie, zapoznaj się z tym przykładem:

<div id="map-container" style="height: 400px; width: 100%;"></div>

<script>
  async function initMap() {
    const {
      AutofitsCameraAnimation,
      Map3DElement,
      Marker3DElement,
      MapMode,
    } = await google.maps.importLibrary('maps3d');

    const map = new Map3DElement({
      mode: MapMode.HYBRID,
      autofitsCameraAnimation: AutofitsCameraAnimation.FLY_TO,
    });
    document.getElementById('map-container').append(map);

    const originMarker = new Marker3DElement({
      position: { lat: 37.7955, lng: -122.3937 },
      autofitsCamera: true,
    });
    map.append(originMarker);

    /* Adding a second opted-in marker flies the camera to frame both. */
    const destinationMarker = new Marker3DElement({
      position: { lat: 37.8080, lng: -122.4177 },
      autofitsCamera: true,
    });
    map.append(destinationMarker);
  }
</script>
<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&loading=async&callback=initMap">
</script>

Zastąp YOUR_API_KEY kluczem interfejsu API Google Maps Platform.

Jak współdziałają właściwości i ograniczenia kamery

Gdy co najmniej 1 element podrzędny wyrazi zgodę na autofits-camera, Map3DElement łączy konfigurację mapy z obliczonymi granicami zgodnie z tymi regułami:

  • center i range: zastępowane przez obliczone kadrowanie, które dodaje 20% dopełnienia zakresu i wymusza minimalny zakres 80 m. Jeśli żaden z elementów podrzędnych, które wyraziły zgodę, nie podaje współrzędnych, mapa używa skonfigurowanych wartości center i range jako wartości zastępczych.
  • tilt i heading: traktowane jako sugerowane wartości podczas kadrowania. Jeśli pominiesz te parametry, domyślnie zostanie ustawiona wartość 0°, co oznacza widok z góry z północą u góry.
  • roll i fov: zachowywane zgodnie z konfiguracją w Map3DElement.
  • Asynchroniczne elementy podrzędne: przed wyrenderowaniem widoku początkowego Map3DElement czeka, aż asynchroniczne elementy podrzędne, które wyraziły zgodę, takie jak <gmp-route-3d>, zakończą wczytywanie geometrii trasy.
  • Ograniczenia dotyczące mapy i kamery: ograniczenia geograficzne (bounds) i ograniczenia dotyczące kamery (minAltitude, maxAltitude, minTilt, maxTilt, minHeading i maxHeading) nadal ograniczają widok dopasowany automatycznie. Więcej informacji znajdziesz w artykule Ograniczanie widoku i granic kamery.

Dalsze kroki