3D Maps

Klasa Map3DElement

google.maps.maps3d.Map3DElement zajęcia

Map3DElement to interfejs HTML widoku mapy 3D. Pamiętaj, że aby rozpocząć renderowanie mapy 3D, musisz ustawić mode.

Element niestandardowy:
<gmp-map-3d center="lat,lng,altitude" default-ui-hidden description="string" gesture-handling="auto" heading="number" internal-usage-attribution-ids="id1 id2" map-id="string" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number" default-ui-disabled></gmp-map-3d>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs Map3DElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {Map3DElement} = await google.maps.importLibrary("maps3d").
Zobacz Biblioteki w Maps JavaScript API.

Zespół
Map3DElement	Map3DElement([options]) Parametry:  options:  Map3DElementOptions optional

Właściwości
bounds	Typ:  LatLngBounds|LatLngBoundsLiteral optional Jeśli jest ustawiona, ogranicza pozycję kamery do określonych granic szerokości i długości geograficznej. Pamiętaj, że obiekty poza granicami są nadal renderowane. Granice mogą ograniczać zarówno długość, jak i szerokość geograficzną, lub tylko jedną z nich. W przypadku granic obejmujących tylko szerokość geograficzną użyj długości geograficznej zachodniej i wschodniej odpowiednio -180 i 180. W przypadku granic obejmujących tylko długość geograficzną użyj szerokości geograficznej północnej i południowej odpowiednio 90 i -90.
center	Typ:  LatLngAltitude|LatLngAltitudeLiteral optional Środek mapy podany jako LatLngAltitude, gdzie wysokość jest podana w metrach nad poziomem gruntu. Pamiętaj, że nie musi to być miejsce, w którym znajduje się kamera, ponieważ pole range wpływa na odległość kamery od środka mapy. Jeśli nie jest ustawiony, przyjmuje się domyślnie {lat: 0, lng: 0, altitude: 63170000}. 63170000 metrów to maksymalna dozwolona wysokość (promień Ziemi pomnożony przez 10). Atrybut HTML: <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultUIHidden	Typ:  boolean optional Domyślnie: false Gdy true, wszystkie domyślne przyciski interfejsu są ukryte. Atrybut HTML: <gmp-map-3d default-ui-hidden></gmp-map-3d>
description	Typ:  string optional Jeśli podasz opis ułatwień dostępu (np. do użytku z czytnikami ekranu), zostanie on dodany do mapy z podaną wartością. Atrybut HTML: <gmp-map-3d description="string"></gmp-map-3d>
gestureHandling	Typ:  GestureHandling optional Domyślnie: GestureHandling.GREEDY Kontroluje obsługę gestów kooperacyjnych. Gdy jest ustawiona wartość COOPERATIVE, do przewijania mapy wymagane są klawisze modyfikujące lub gesty dwoma palcami. Jeśli ustawisz wartość GREEDY, nie będzie można przewijać strony hosta za pomocą zdarzeń użytkownika w elemencie mapy. Jeśli ustawisz wartość AUTO, obsługa gestów będzie zależeć od możliwości przewijania strony hosta. Atrybut HTML: <gmp-map-3d gesture-handling="auto"></gmp-map-3d> <gmp-map-3d gesture-handling="cooperative"></gmp-map-3d> <gmp-map-3d gesture-handling="greedy"></gmp-map-3d>
heading	Typ:  number optional Kierunek kompasu na mapie w stopniach, gdzie północ to zero. Jeśli nie ma przechylenia, każdy obrót będzie interpretowany jako kierunek. Atrybut HTML: <gmp-map-3d heading="number"></gmp-map-3d>
internalUsageAttributionIds	Typ:  Iterable<string> optional Dodaje identyfikator atrybucji wykorzystania do inicjatora, co pomaga Google zrozumieć, które biblioteki i przykłady są przydatne dla deweloperów, np. wykorzystanie rozwiązania do łączenia znaczników w klastry. Aby zrezygnować z wysyłania identyfikatora atrybucji wykorzystania, możesz bezpiecznie usunąć tę właściwość. Wysyłane będą tylko unikalne wartości. Zmiany tej wartości po utworzeniu instancji mogą zostać zignorowane. Atrybut HTML: <gmp-map-3d internal-usage-attribution-ids="id1 id2"></gmp-map-3d>
language	Typ:  string optional Język, w którym ma być renderowany język mapy podstawowej. Domyślnie będzie to język żądany przez dewelopera podczas wczytywania interfejsu Maps JavaScript API.
mapId	Typ:  string optional Określa identyfikator mapy, który będzie używany do pobierania stylu mapy w chmurze. Nie należy ustawiać tej wartości po zainicjowaniu mapy. Dlatego upewniamy się, że identyfikator mapId jest ustawiany tylko podczas inicjowania, i nie publikujemy tego atrybutu w kanałach publicznych. Atrybut HTML: <gmp-map-3d map-id="string"></gmp-map-3d>
maxAltitude	Typ:  number optional Maksymalna wysokość nad ziemią, która będzie wyświetlana na mapie. Prawidłowa wartość mieści się w zakresie od 0 do 63170000 metrów (promień Ziemi pomnożony przez 10). Atrybut HTML: <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading	Typ:  number optional Maksymalny kąt kierunku (obrotu) mapy. Prawidłowa wartość mieści się w zakresie od 0 do 360 stopni. minHeading i maxHeading reprezentują interwał <= 360 stopni, w którym gesty nagłówka będą dozwolone. minHeading = 180 i maxHeading = 90 pozwolą na nagłówek w [0, 90] i nagłówek w [180, 360]. minHeading = 90 i maxHeading = 180 pozwolą na kierowanie się w stronę [90, 180]. Atrybut HTML: <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt	Typ:  number optional Maksymalny kąt padania mapy. Prawidłowa wartość mieści się w zakresie od 0 do 90 stopni. Atrybut HTML: <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude	Typ:  number optional Minimalna wysokość nad ziemią, która będzie wyświetlana na mapie. Prawidłowa wartość mieści się w zakresie od 0 do 63170000 metrów (promień Ziemi pomnożony przez 10). Atrybut HTML: <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading	Typ:  number optional Minimalny kąt kierunku (obrotu) mapy. Prawidłowa wartość mieści się w zakresie od 0 do 360 stopni. minHeading i maxHeading reprezentują interwał <= 360 stopni, w którym gesty nagłówka będą dozwolone. minHeading = 180 i maxHeading = 90 pozwolą na nagłówek w [0, 90] i nagłówek w [180, 360]. minHeading = 90 i maxHeading = 180 pozwolą na kierowanie się w stronę [90, 180]. Atrybut HTML: <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt	Typ:  number optional Minimalny kąt padania na mapie. Prawidłowa wartość mieści się w zakresie od 0 do 90 stopni. Atrybut HTML: <gmp-map-3d min-tilt="number"></gmp-map-3d>
mode	Typ:  MapMode optional Określa tryb, w którym ma być renderowana mapa. Jeśli nie zostanie ustawiony, mapa nie będzie renderowana. Atrybut HTML: <gmp-map-3d mode="hybrid"></gmp-map-3d> <gmp-map-3d mode="satellite"></gmp-map-3d>
range	Typ:  number optional Odległość od kamery do środka mapy w metrach. Atrybut HTML: <gmp-map-3d range="number"></gmp-map-3d>
region	Typ:  string optional Region, w którym ma zostać podjęta próba wyrenderowania ciekawych miejsc na mapie podstawowej. Domyślnie będzie to region żądany przez dewelopera podczas wczytywania interfejsu Maps JavaScript API.
roll	Typ:  number optional Przechylenie kamery wokół wektora widoku wyrażone w stopniach. Aby uniknąć niejednoznaczności, gdy nie ma przechylenia, każdy obrót będzie interpretowany jako kierunek. Atrybut HTML: <gmp-map-3d roll="number"></gmp-map-3d>
tilt	Typ:  number optional Nachylenie wektora widoku kamery w stopniach. Wektor widoku skierowany bezpośrednio w dół na Ziemię ma nachylenie 0 stopni. Wektor widoku skierowany od Ziemi miałby nachylenie 180 stopni. Atrybut HTML: <gmp-map-3d tilt="number"></gmp-map-3d>
defaultUIDisabled	Wycofane: zamiast tego użyj Map3DElement.defaultUIHidden. Ta właściwość zostanie usunięta w przyszłej wersji. Typ:  boolean optional Domyślnie: false Gdy true, wszystkie domyślne przyciski interfejsu są wyłączone. Nie wyłącza klawiatury ani sterowania gestami. Atrybut HTML: <gmp-map-3d default-ui-disabled></gmp-map-3d>

Metody
addEventListener	addEventListener(type, listener[, options]) Parametry:  type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane. listener:  EventListener|EventListenerObject Obiekt, który otrzymuje powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent options:  boolean|AddEventListenerOptions optional Zobacz opcje. Zdarzenia niestandardowe obsługują tylko te parametry: capture i passive. Wartość zwracana:  void Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
flyCameraAround	flyCameraAround(options) Parametry:  options:  FlyAroundAnimationOptions Zwracana wartość: brak Ta metoda powoduje, że kamera porusza się po orbicie wokół danej lokalizacji przez określony czas. Animację można powtórzyć określoną liczbę razy (FlyAroundAnimationOptions.repeatCount). Kamera będzie się obracać w prawo. Metoda jest asynchroniczna, ponieważ animacje mogą się rozpocząć dopiero po załadowaniu minimalnej ilości danych mapy. Metoda zwraca wartość po rozpoczęciu animacji. Jeśli liczba obrotów FlyAroundAnimationOptions.repeatCount wynosi 0, obrót nie nastąpi, a animacja zakończy się natychmiast po rozpoczęciu.
flyCameraTo	flyCameraTo(options) Parametry:  options:  FlyToAnimationOptions Zwracana wartość: brak Ta metoda przesuwa kamerę parabolicznie z bieżącej lokalizacji do podanej lokalizacji końcowej w określonym czasie. Metoda jest asynchroniczna, ponieważ animacje mogą się rozpocząć dopiero po załadowaniu minimalnej ilości danych mapy. Metoda zwraca wartość po rozpoczęciu animacji.
removeEventListener	removeEventListener(type, listener[, options]) Parametry:  type:  string ciąg znaków określający typ zdarzenia, dla którego ma zostać usunięty detektor zdarzeń. listener:  EventListener|EventListenerObject Detektor zdarzeń modułu obsługi zdarzeń, który ma zostać usunięty z elementu docelowego zdarzenia. options:  boolean|EventListenerOptions optional Zobacz opcje. Wartość zwracana:  void Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
stopCameraAnimation	stopCameraAnimation() Parametry: brak Zwracana wartość: brak Ta metoda zatrzymuje wszystkie animacje lotu, które mogą być uruchomione. Kamera pozostaje w miejscu, w którym znajduje się w połowie animacji, i nie teleportuje się do punktu końcowego. Metoda jest asynchroniczna, ponieważ animacje mogą się rozpocząć lub zatrzymać dopiero po załadowaniu minimalnej ilości danych mapy. Metoda zwraca wartość po zatrzymaniu animacji.

Wydarzenia
gmp-animationend	function(animationEndEvent) Argumenty:  animationEndEvent:  Event To zdarzenie jest wywoływane po zakończeniu animacji przelotu. To zdarzenie jest przekazywane w górę drzewa DOM.
gmp-centerchange	function(centerChangeEvent) Argumenty:  centerChangeEvent:  Event To zdarzenie jest wywoływane, gdy zmienia się właściwość center elementu Map3DElement.
gmp-click	function(clickEvent) Argumenty:  clickEvent:  LocationClickEvent|PlaceClickEvent To zdarzenie jest wywoływane po kliknięciu elementu Map3DElement.
gmp-error	function(mapInitializationErrorEvent) Argumenty:  mapInitializationErrorEvent:  Event To zdarzenie jest wywoływane, gdy nie uda się zainicjować mapy.
gmp-headingchange	function(headingChangeEvent) Argumenty:  headingChangeEvent:  Event To zdarzenie jest wywoływane, gdy zmienia się właściwość heading elementu Map3DElement.
gmp-map-id-error	function(mapIdErrorEvent) Argumenty:  mapIdErrorEvent:  Event To zdarzenie jest wywoływane, gdy właściwość mapId elementu Map3DElement jest nieprawidłowa.
gmp-rangechange	function(rangeChangeEvent) Argumenty:  rangeChangeEvent:  Event To zdarzenie jest wywoływane, gdy zmienia się właściwość range elementu Map3DElement.
gmp-rollchange	function(rollChangeEvent) Argumenty:  rollChangeEvent:  Event To zdarzenie jest wywoływane, gdy zmienia się właściwość roll elementu Map3DElement.
gmp-steadychange	function(steadyChangeEvent) Argumenty:  steadyChangeEvent:  SteadyChangeEvent To zdarzenie jest wywoływane, gdy zmienia się stan stabilny elementu Map3DElement.
gmp-tiltchange	function(tiltChangeEvent) Argumenty:  tiltChangeEvent:  Event To zdarzenie jest wywoływane, gdy zmienia się właściwość tilt elementu Map3DElement.

Interfejs Map3DElementOptions

Interfejs google.maps.maps3d.Map3DElementOptions

Obiekt Map3DElementOptions służący do definiowania właściwości, które można ustawić w obiekcie Map3DElement.

Właściwości
bounds optional	Typ:  LatLngBounds|LatLngBoundsLiteral optional Zobacz Map3DElement.bounds.
center optional	Typ:  LatLngAltitude|LatLngAltitudeLiteral optional Zobacz Map3DElement.center.
defaultUIDisabled optional	Wycofane: zamiast tego użyj Map3DElement.defaultUIHidden. Ta właściwość zostanie usunięta w przyszłej wersji. Typ:  boolean optional Zobacz Map3DElement.defaultUIDisabled.
defaultUIHidden optional	Typ:  boolean optional Zobacz Map3DElement.defaultUIHidden.
description optional	Typ:  string optional Zobacz Map3DElement.description.
gestureHandling optional	Typ:  GestureHandling optional Zobacz Map3DElement.gestureHandling.
heading optional	Typ:  number optional Zobacz Map3DElement.heading.
internalUsageAttributionIds optional	Typ:  Iterable<string> optional Zobacz Map3DElement.internalUsageAttributionIds.
language optional	Typ:  string optional Zobacz Map3DElement.language.
mapId optional	Typ:  string optional Zobacz Map3DElement.mapId.
maxAltitude optional	Typ:  number optional Zobacz Map3DElement.maxAltitude.
maxHeading optional	Typ:  number optional Zobacz Map3DElement.maxHeading.
maxTilt optional	Typ:  number optional Zobacz Map3DElement.maxTilt.
minAltitude optional	Typ:  number optional Zobacz Map3DElement.minAltitude.
minHeading optional	Typ:  number optional Zobacz Map3DElement.minHeading.
minTilt optional	Typ:  number optional Zobacz Map3DElement.minTilt.
mode optional	Typ:  MapMode optional Zobacz Map3DElement.mode.
range optional	Typ:  number optional Zobacz Map3DElement.range.
region optional	Typ:  string optional Zobacz Map3DElement.region.
roll optional	Typ:  number optional Zobacz Map3DElement.roll.
tilt optional	Typ:  number optional Zobacz Map3DElement.tilt.

Stałe MapMode

google.maps.maps3d.MapMode stałe

Określa tryb, w którym ma być renderowana mapa.

Aby uzyskać dostęp, zadzwoń pod numer const {MapMode} = await google.maps.importLibrary("maps3d").
Zobacz Biblioteki w Maps JavaScript API.

Stałe
HYBRID	Ten tryb mapy wyświetla przezroczystą warstwę głównych ulic na zdjęciach satelitarnych lub fotorealistycznych.
SATELLITE	Ten tryb mapy wyświetla zdjęcia satelitarne lub fotorealistyczne, jeśli są dostępne.

Stałe GestureHandling

google.maps.maps3d.GestureHandling stałe

Określa, jak zdarzenia gestów powinny być obsługiwane w elemencie mapy.

Aby uzyskać dostęp, zadzwoń pod numer const {GestureHandling} = await google.maps.importLibrary("maps3d").
Zobacz Biblioteki w Maps JavaScript API.

Stałe
AUTO	Dzięki temu mapa może wybrać, czy ma używać obsługi gestów w trybie współpracy czy w trybie zachłannym. Jest to działanie domyślne, jeśli nie określono inaczej. Spowoduje to, że mapa przejdzie w tryb współpracy, jeśli mapa dominuje nad elementem nadrzędnym przewijania (zwykle stroną hosta) do tego stopnia, że użytkownik nie może przewinąć mapy do innych treści.
COOPERATIVE	Wymusza to tryb współpracy, w którym do przewijania mapy wymagane są klawisze modyfikujące lub gesty dwoma palcami.
GREEDY	Wymusza to tryb zachłanny, w którym nie można przewijać strony hosta za pomocą zdarzeń użytkownika w elemencie mapy.

FlyAroundAnimationOptions interfejs

Interfejs google.maps.maps3d.FlyAroundAnimationOptions

Opcje dostosowywania animacji FlyCameraAround.

Właściwości
camera	Typ:  CameraOptions Punkt centralny, na który kamera powinna być skierowana podczas animacji orbity. Zwróć uwagę, że kierunek mapy będzie się zmieniać, gdy kamera będzie się obracać wokół tego punktu centralnego.
durationMillis optional	Typ:  number optional Czas trwania jednego cyklu animacji w milisekundach.
repeatCount optional	Typ:  number optional Określa liczbę powtórzeń animacji. Jeśli liczba wynosi 0, animacja zakończy się natychmiast po rozpoczęciu.
rounds optional	Wycofane: zamiast tego użyj FlyAroundAnimationOptions.repeatCount. Typ:  number optional Liczba obrotów wokół środka w danym czasie. To ustawienie określa ogólną szybkość obracania. Przekazanie ujemnej liczby do parametru rounds spowoduje obrót aparatu w lewo, a nie w prawo (domyślnie).

Interfejs FlyToAnimationOptions

Interfejs google.maps.maps3d.FlyToAnimationOptions

Opcje dostosowywania animacji FlyCameraTo.

Właściwości
endCamera	Typ:  CameraOptions Lokalizacja, na którą kamera powinna być skierowana na końcu animacji.
durationMillis optional	Typ:  number optional Czas trwania animacji w milisekundach. Czas trwania 0 spowoduje natychmiastowe przeniesienie kamery do pozycji końcowej.

CameraOptions interface

Interfejs google.maps.maps3d.CameraOptions

Obiekt CameraOptions służy do definiowania właściwości, które można ustawić w obiekcie kamery. Obiekt kamery może być dowolnym elementem, który ma pozycję kamery, np. bieżącym stanem mapy lub przyszłym żądanym stanem animacji.

Właściwości
center optional	Typ:  LatLngAltitude|LatLngAltitudeLiteral optional Zobacz Map3DElement.center.
heading optional	Typ:  number optional Zobacz Map3DElement.heading.
range optional	Typ:  number optional Zobacz Map3DElement.range.
roll optional	Typ:  number optional Zobacz Map3DElement.roll.
tilt optional	Typ:  number optional Zobacz Map3DElement.tilt.

Klasa SteadyChangeEvent

google.maps.maps3d.SteadyChangeEvent zajęcia

To zdarzenie jest tworzone na podstawie monitorowania stanu stabilnego Map3DElement. To zdarzenie jest przekazywane w górę drzewa DOM.

Ta klasa rozszerza klasę Event.

Aby uzyskać dostęp, zadzwoń pod numer const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d").
Zobacz Biblioteki w Maps JavaScript API.

Właściwości
isSteady	Typ:  boolean Wskazuje, czy element Map3DElement jest stabilny (tzn. czy zakończyło się renderowanie bieżącej sceny).

Klasa LocationClickEvent

google.maps.maps3d.LocationClickEvent zajęcia

To zdarzenie jest tworzone po kliknięciu elementu Map3DElement.

Ta klasa rozszerza klasę Event.

Aby uzyskać dostęp, zadzwoń pod numer const {LocationClickEvent} = await google.maps.importLibrary("maps3d").
Zobacz Biblioteki w Maps JavaScript API.

Właściwości

position

Typ:  LatLngAltitude optional Szerokość/długość geograficzna/wysokość, która znajdowała się pod kursorem w momencie wystąpienia zdarzenia. Pamiętaj, że na mniej szczegółowych poziomach zwracane dane będą mniej dokładne. W przypadku kliknięcia powierzchni wody z wyższych pozycji kamery jako wartość wysokości może zostać zwrócona wysokość dna morskiego. To zdarzenie jest przekazywane w górę drzewa DOM.

Klasa PlaceClickEvent

google.maps.maps3d.PlaceClickEvent zajęcia

To wydarzenie jest tworzone po kliknięciu ikony miejsca na Map3DElement. Aby zapobiec wyświetlaniu domyślnego wyskakującego okienka, wywołaj metodę preventDefault() w tym zdarzeniu, aby zapobiec jego obsłudze przez Map3DElement.

Ta klasa rozszerza klasę LocationClickEvent.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceClickEvent} = await google.maps.importLibrary("maps3d").
Zobacz Biblioteki w Maps JavaScript API.

Właściwości
placeId	Typ:  string Identyfikator miejsca na mapie.
Dziedziczone: position

Metody

fetchPlace

fetchPlace() Parametry: brak Wartość zwracana:  Promise<Place> Pobiera Place dla tego identyfikatora miejsca. W powstałym obiekcie Place zostanie wypełniona właściwość id. O dodatkowe pola można później poprosić za pomocą Place.fetchFields(), pod warunkiem że interfejs Places API jest włączony i rozliczany w normalny sposób. Jeśli podczas pobierania Place wystąpi błąd, obietnica zostanie odrzucona.