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, aFLY_TOpowraca 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:
centerirange: 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ścicenterirangejako wartości zastępczych.tiltiheading: 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.rollifov: zachowywane zgodnie z konfiguracją wMap3DElement.- Asynchroniczne elementy podrzędne: przed wyrenderowaniem widoku początkowego
Map3DElementczeka, 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,minHeadingimaxHeading) nadal ograniczają widok dopasowany automatycznie. Więcej informacji znajdziesz w artykule Ograniczanie widoku i granic kamery.