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.
gmp-click
function(clickEvent)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu elementu Map3DElement.
gmp-headingchange
function(headingChangeEvent)
Argumenty: 
  • headingChangeEvent:  Event
To zdarzenie jest wywoływane, gdy zmienia się właściwość heading elementu Map3DElement.
gmp-rangechange
function(rangeChangeEvent)
Argumenty: 
  • rangeChangeEvent:  Event
To zdarzenie jest wywoływane, gdy zmienia się właściwość range obiektu Map3DElement.
gmp-rollchange
function(rollChangeEvent)
Argumenty: 
  • rollChangeEvent:  Event
To zdarzenie jest wywoływane, gdy zmienia się właściwość roll obiektu Map3DElement.
gmp-steadychange
function(steadyChangeEvent)
Argumenty: 
To zdarzenie jest wywoływane, gdy zmienia się stan stabilny Map3DElement.
gmp-tiltchange
function(tiltChangeEvent)
Argumenty: 
  • tiltChangeEvent:  Event
To zdarzenie jest wywoływane, gdy zmienia się właściwość tilt elementu Map3DElement.

Map3DElementOptions interfejs

google.maps.maps3d.Map3DElementOptionsinterfejs

Obiekt Map3DElementOptions używany do definiowania właściwości, które można ustawić w obiekcie Map3DElement.
bounds optional
Zobacz Map3DElement.bounds.
center optional
Zobacz Map3DElement.center.
defaultLabelsDisabled optional
Typ:  boolean optional
Zobacz Map3DElement.defaultLabelsDisabled.
defaultUIDisabled optional
Typ:  boolean optional
Zobacz Map3DElement.defaultUIDisabled.
heading optional
Typ:  number optional
Zobacz Map3DElement.heading.
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.
range optional
Typ:  number optional
Zobacz Map3DElement.range.
roll optional
Typ:  number optional
Zobacz Map3DElement.roll.
tilt optional
Typ:  number optional
Zobacz Map3DElement.tilt.

FlyAroundAnimationOptions interfejs

google.maps.maps3d.FlyAroundAnimationOptionsinterfejs

Opcje dostosowywania animacji FlyCameraAround.
camera
Centralny punkt, na który kamera powinna być skierowana podczas animacji orbity. Pamiętaj, że kierunek mapy będzie się zmieniać, gdy kamera będzie orbitować wokół tego punktu środkowego.
durationMillis optional
Typ:  number optional
Czas trwania animacji w milisekundach. Jest to łączny czas trwania animacji, a nie czas trwania pojedynczego obrotu.
rounds optional
Typ:  number optional
Liczba obrotów wokół środka w danym czasie. Określa ogólną szybkość obrotu. Przekazanie do funkcji rounds liczby ujemnej spowoduje obrót kamery w kierunku przeciwnym do ruchu wskazówek zegara zamiast domyślnego kierunku zgodnego z ruchem wskazówek zegara.

FlyToAnimationOptions interfejs

google.maps.maps3d.FlyToAnimationOptionsinterfejs

Opcje dostosowywania animacji FlyCameraTo.
endCamera
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 teleportowanie kamery bezpośrednio do pozycji końcowej.

CameraOptions interfejs

google.maps.maps3d.CameraOptionsinterfejs

Obiekt CameraOptions używany do definiowania właściwości, które można ustawić w obiekcie kamery. Obiekt kamery może być dowolnym obiektem, który ma pozycję kamery, np. bieżący stan mapy lub przyszły stan animacji.
center 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.

SteadyChangeEvent class

google.maps.maps3d.SteadyChangeEvent zajęcia

To zdarzenie jest tworzone na podstawie monitorowania stanu ustalonego Map3DElement. To zdarzenie propaguje się w górę drzewa DOM.

Ta klasa rozszerza klasę Event.

Dostęp przez połączenie pod numer const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
isSteady
Typ:  boolean
Wskazuje, czy Map3DElement jest stabilny (tzn. renderowanie bieżącej sceny zostało zakończone).

LocationClickEvent class

google.maps.maps3d.LocationClickEvent zajęcia

To zdarzenie jest tworzone po kliknięciu elementu Map3DElement.

Ta klasa rozszerza klasę Event.

Dostęp przez połączenie pod numer const {LocationClickEvent} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
position
Typ:  LatLngAltitude optional
Szerokość i długość geograficzna oraz wysokość nad poziomem morza w miejscu, w którym znajdował się kursor w momencie wystąpienia zdarzenia. Pamiętaj, że na wyższych poziomach szczegółowości zwracane dane będą mniej dokładne. W przypadku kliknięcia powierzchni wody z wyższych pozycji kamery w wartości wysokości może być też zwracana wysokość dna morskiego. To zdarzenie propaguje się w górę drzewa DOM.

PlaceClickEvent class

google.maps.maps3d.PlaceClickEvent zajęcia

To zdarzenie jest tworzone po kliknięciu elementu Map3DElement.

Ta klasa rozszerza klasę LocationClickEvent.

Dostęp przez połączenie pod numer const {PlaceClickEvent} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
placeId
Typ:  string
Identyfikator miejsca elementu mapy.
Dziedziczone: position
fetchPlace
fetchPlace()
Parametry: brak
Zwracana wartość: