3D Maps

Map3DElement class

google.maps.maps3d.Map3DElement zajęcia

Map3DElement to interfejs HTML widoku mapy 3D.

Element niestandardowy:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" range="number" roll="number" tilt="number"></gmp-map-3d>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs Map3DElementOptions.

Dostęp przez połączenie pod numer const {Map3DElement} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
Map3DElement
Map3DElement([options])
Parametry: 
bounds
Po ustawieniu ogranicza pozycję kamery do określonych granic współrzędnych geograficznych. Pamiętaj, że obiekty znajdujące się 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 geograficznych zachodniej i wschodniej odpowiednio -180 i 180. W przypadku granic obejmujących tylko długość geograficzną użyj szerokości geograficznych północnej i południowej odpowiednio 90 i -90.
center
Środek mapy podany jako LatLngAltitude, gdzie wysokość jest podana w metrach nad poziomem gruntu. Pamiętaj, że niekoniecznie jest to miejsce, w którym znajduje się kamera, ponieważ pole range wpływa na odległość kamery od środka mapy. Jeśli nie podasz tu żadnej wartości, zostanie użyta wartość domyślna {lat: 0, lng: 0, altitude: 63170000}. Maksymalna dozwolona wysokość to 63170000 metrów (promień Ziemi pomnożony przez 10).
Atrybut HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultLabelsDisabled
Typ:  boolean optional
Domyślnie: false
Gdy true, domyślne etykiety mapy nie są renderowane.
Atrybut HTML:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
Typ:  boolean optional
Domyślnie: false
Gdy ta opcja jest włączona 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>
heading
Typ:  number optional
Kierunek kompasu na mapie w stopniach, gdzie północ to zero. Jeśli nie ma pochylenia, każdy obrót będzie interpretowany jako kierunek.
Atrybut HTML:
  • <gmp-map-3d heading="number"></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ą przedział <= 360 stopni, w którym będą dozwolone gesty kierunku. minHeading = 180 i maxHeading = 90 umożliwią kierowanie w [0, 90] i [180, 360]. minHeading = 90 i maxHeading = 180 umożliwią wyświetlanie nagłówka w [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ą przedział <= 360 stopni, w którym będą dozwolone gesty kierunku. minHeading = 180 i maxHeading = 90 umożliwią kierowanie w [0, 90] i [180, 360]. minHeading = 90 i maxHeading = 180 umożliwią wyświetlanie nagłówka w [90, 180].
Atrybut HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Typ:  number optional
Minimalny kąt padania mapy. Prawidłowa wartość mieści się w zakresie od 0 do 90 stopni.
Atrybut HTML:
  • <gmp-map-3d min-tilt="number"></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>
roll
Typ:  number optional
Kąt obrotu kamery wokół wektora widoku wyrażony w stopniach. Aby uniknąć niejednoznaczności, w przypadku braku pochylenia każdy obrót będzie interpretowany jako kierunek.
Atrybut HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
Typ:  number optional
Pochylenie wektora widoku kamery w stopniach. Wektor widoku skierowany bezpośrednio w dół na Ziemię miałby nachylenie 0 stopni. Wektor widoku skierowany od Ziemi będzie miał nachylenie 180 stopni.
Atrybut HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string Ciąg znaków z uwzględnieniem wielkości liter reprezentujący typ zdarzenia, którego chcesz nasłuchiwać.
  • 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 capture i passive.
Zwracana wartość:  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: 
Zwracana wartość: brak
Ta metoda obraca kamerę wokół danej lokalizacji przez określony czas, wykonując w tym czasie określoną liczbę obrotów.

 Domyślnie kamera porusza się po orbicie zgodnie z ruchem wskazówek zegara. Jeśli podasz ujemną liczbę okrążeń, kamera będzie obracać się w kierunku przeciwnym do ruchu wskazówek zegara.

Metoda jest asynchroniczna, ponieważ animacje mogą się rozpocząć dopiero po załadowaniu minimalnej ilości mapy. Metoda zwraca wartość po rozpoczęciu animacji.

 Jeśli liczba rund wynosi zero, nie nastąpi obrót, a animacja zakończy się natychmiast po rozpoczęciu.
flyCameraTo
flyCameraTo(options)
Parametry: 
Zwracana wartość: brak
Ta metoda powoduje paraboliczne przesunięcie kamery z bieżącej lokalizacji do określonej lokalizacji końcowej w określonym czasie.

Metoda jest asynchroniczna, ponieważ animacje mogą się rozpocząć dopiero po załadowaniu minimalnej ilości mapy. Metoda zwraca wartość po rozpoczęciu animacji.
BetaremoveEventListener
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 obiektu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional zobacz opcje.
Zwracana wartość:  void
Usuwa z obiektu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
stopCameraAnimation
stopCameraAnimation()
Parametry: brak
Zwracana wartość: brak
Ta metoda zatrzymuje każdą animację lotu, która może być w toku. Kamera pozostaje w miejscu, w którym znajduje się w trakcie animacji. Nie przenosi się do punktu końcowego.

 Metoda jest asynchroniczna, ponieważ animacje można uruchamiać i zatrzymywać dopiero po wczytaniu minimalnej ilości danych mapy. Metoda zwraca wartość po zatrzymaniu animacji.
gmp-animationend
function(animationEndEvent)
Argumenty: 
  • animationEndEvent:  Event
To zdarzenie jest uruchamiane po zakończeniu animacji przelotu. To zdarzenie propaguje się 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.