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ść:  Promise<Place>
Pobiera Place dla tego identyfikatora miejsca. W wynikowym obiekcie Place zostanie wypełniona właściwość id. Dodatkowe pola można później uzyskać za pomocą Place.fetchFields(), z zastrzeżeniem normalnego włączenia interfejsu Places API i rozliczeń. Obietnica jest odrzucana, jeśli podczas pobierania konsoli Place wystąpił błąd.

Marker3DElement class

google.maps.maps3d.Marker3DElement zajęcia

Wyświetla pozycję na mapie 3D. Pamiętaj, że aby wyświetlić Marker3DElement, musisz ustawić position.

Element niestandardowy:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" size-preserved z-index="number"></gmp-marker-3d>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs Marker3DElementOptions.

Dostęp przez połączenie pod numer const {Marker3DElement} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
Marker3DElement
Marker3DElement([options])
Parametry: 
Tworzy element Marker3DElement z określonymi opcjami.
altitudeMode
Typ:  AltitudeMode optional
Domyślnie: AltitudeMode.CLAMP_TO_GROUND
Określa sposób interpretacji komponentu wysokości pozycji.
Atrybut HTML:
  • <gmp-marker-3d altitude-mode="absolute"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="clamp-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-mesh"></gmp-marker-3d>
collisionBehavior
Typ:  CollisionBehavior optional
Domyślnie: CollisionBehavior.REQUIRED
Wyliczenie określające, jak element Marker3DElement powinien się zachowywać, gdy zderzy się z innym elementem Marker3DElement lub z etykietami mapy bazowej.
Atrybut HTML:
  • <gmp-marker-3d collision-behavior="required"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="required-and-hides-optional"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="optional-and-hides-lower-priority"></gmp-marker-3d>
drawsWhenOccluded
Typ:  boolean optional
Domyślnie: false
Określa, czy ten znacznik ma być rysowany, gdy jest zasłonięty. Marker może być zasłonięty przez geometrię mapy (np. budynki).
Atrybut HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
Typ:  boolean optional
Domyślnie: false
Określa, czy znacznik ma być połączony z podłożem. Aby wyciągnąć znacznik, wartość altitudeMode musi być równa RELATIVE_TO_GROUND lub ABSOLUTE.
Atrybut HTML:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
Typ:  string optional
Tekst, który ma być wyświetlany przez ten znacznik.
Atrybut HTML:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
Lokalizacja końcówki znacznika. W niektórych trybach wysokość jest ignorowana, więc jest opcjonalna.
sizePreserved
Typ:  boolean optional
Domyślnie: false
Określa, czy ten znacznik ma zachowywać swój rozmiar niezależnie od odległości od kamery. Domyślnie znacznik jest skalowany na podstawie odległości od kamery lub nachylenia.
Atrybut HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
Typ:  number optional
Wartość zIndex w porównaniu z innymi znacznikami.
Atrybut HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Wszystkie elementy niestandardowe dodane bezpośrednio do elementu Marker3DElement zostaną umieszczone w odpowiednich miejscach, ale do rysowania markerów będą używane tylko elementy typu HTMLImageElement, SVGElement i PinElement. Pozostałe elementy będą ignorowane. Elementy
HTMLImageElement i SVGElement muszą być umieszczone w elemencie <template> przed przypisaniem do domyślnego miejsca na reklamę w elemencie Marker3DElement.

Obrazy i pliki SVG są obecnie rastrowane przed wyrenderowaniem w scenie 3D, więc niestandardowy kod HTML osadzony w pliku SVG lub klasy CSS dodane do obrazów nie zostaną zastosowane i mogą nie być widoczne, gdy znaczniki są wyświetlane na ekranie.
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.
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.

Marker3DElementOptions interfejs

google.maps.maps3d.Marker3DElementOptionsinterfejs

Obiekt Marker3DElementOptions służący do definiowania właściwości, które można ustawić w obiekcie Marker3DElement.
altitudeMode optional
Typ:  AltitudeMode optional
Zobacz Marker3DElement.altitudeMode.
collisionBehavior optional
Typ:  CollisionBehavior optional
Zobacz Marker3DElement.collisionBehavior.
drawsWhenOccluded optional
Typ:  boolean optional
Zobacz Marker3DElement.drawsWhenOccluded.
extruded optional
Typ:  boolean optional
Zobacz Marker3DElement.extruded.
label optional
Typ:  string optional
Zobacz Marker3DElement.label.
position optional
Zobacz Marker3DElement.position.
sizePreserved optional
Typ:  boolean optional
Zobacz Marker3DElement.sizePreserved.
zIndex optional
Typ:  number optional
Zobacz Marker3DElement.zIndex.

Marker3DInteractiveElement class

google.maps.maps3d.Marker3DInteractiveElement zajęcia

Wyświetla pozycję na mapie 3D. Pamiętaj, że aby wyświetlić Marker3DInteractiveElement, musisz ustawić position. W przeciwieństwie do Marker3DElement, Marker3DInteractiveElement otrzymuje zdarzenie gmp-click.

Element niestandardowy:
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>

Ta klasa rozszerza klasę Marker3DElement.

Ta klasa implementuje interfejs Marker3DInteractiveElementOptions.

Dostęp przez połączenie pod numer const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Parametry: 
Tworzy element Marker3DInteractiveElement z określonymi opcjami.
Odziedziczone: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex
default
Wszystkie elementy niestandardowe dodane bezpośrednio do elementu Marker3DInteractiveElement zostaną umieszczone w odpowiednich miejscach, ale do rysowania znaczników będą używane tylko elementy typu PinElement. Pozostałe elementy zostaną zignorowane.
addEventListener
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
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 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
gmp-click
function(clickEvent)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu elementu Marker3DInteractiveElement.

Marker3DInteractiveElementOptions interfejs

google.maps.maps3d.Marker3DInteractiveElementOptionsinterfejs

Obiekt Marker3DInteractiveElementOptions służący do definiowania właściwości, które można ustawić w elemencie Marker3DInteractiveElement.

Ten interfejs rozszerza interfejs Marker3DElementOptions.

Odziedziczone: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Model3DElement class

google.maps.maps3d.Model3DElement zajęcia

Model 3D, który umożliwia renderowanie modeli gLTF. Pamiętaj, że aby wyświetlić element Model3DElement, musisz ustawić elementy position i src.

 Powinny być obsługiwane podstawowe właściwości gLTF PBR. Obecnie nie obsługujemy rozszerzeń ani właściwości rozszerzeń.

Element niestandardowy:
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs Model3DElementOptions.

Dostęp przez połączenie pod numer const {Model3DElement} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
Model3DElement
Model3DElement([options])
Parametry: 
Tworzy element Model3DElement z określonymi opcjami.
altitudeMode
Typ:  AltitudeMode optional
Domyślnie: AltitudeMode.CLAMP_TO_GROUND
Określa sposób interpretacji wysokości w pozycji.
Atrybut HTML:
  • <gmp-model-3d altitude-mode="absolute"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="clamp-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-mesh"></gmp-model-3d>
orientation
Opisuje rotację układu współrzędnych modelu 3D, aby umieścić go na mapie 3D.

 Obrót modelu odbywa się w tej kolejności: obrót wokół osi podłużnej, obrót wokół osi poprzecznej, a potem obrót wokół osi pionowej.
position
Ustawia pozycję Model3DElement. W niektórych trybach wysokość jest ignorowana, więc jest opcjonalna.
scale
Typ:  number|Vector3D|Vector3DLiteral optional
Domyślnie: 1
Skaluje model wzdłuż osi X, Y i Z w przestrzeni współrzędnych modelu.
src
Typ:  string|URL optional
Określa adres URL modelu 3D. Obecnie obsługiwane są tylko modele w formacie .glb.

 Wszystkie względne adresy URL HTTP zostaną przekształcone w odpowiadające im bezwzględne adresy URL.

Pamiętaj, że jeśli przechowujesz pliki modelu .glb w innej witrynie lub na innym serwerze niż główna aplikacja, musisz skonfigurować prawidłowe nagłówki HTTP CORS. Dzięki temu aplikacja będzie mieć bezpieczny dostęp do plików modelu z innej domeny.
Atrybut HTML:
  • <gmp-model-3d src="src"></gmp-model-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.
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.

Model3DElementOptions interfejs

google.maps.maps3d.Model3DElementOptionsinterfejs

Obiekt Model3DElementOptions używany do definiowania właściwości, które można ustawić w obiekcie Model3DElement.
altitudeMode optional
Typ:  AltitudeMode optional
Zobacz Model3DElement.altitudeMode.
orientation optional
Zobacz Model3DElement.orientation.
position optional
Zobacz Model3DElement.position.
scale optional
Typ:  number|Vector3D|Vector3DLiteral optional
Zobacz Model3DElement.scale.
src optional
Typ:  string|URL optional
Zobacz Model3DElement.src.

Polyline3DElement class

google.maps.maps3d.Polyline3DElement zajęcia

Linia łamana 3D to liniowa nakładka połączonych odcinków na mapie 3D.

Element niestandardowy:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs Polyline3DElementOptions.

Dostęp przez połączenie pod numer const {Polyline3DElement} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
Polyline3DElement
Polyline3DElement([options])
Parametry: 
Tworzy element Polyline3DElement z określonymi opcjami.
altitudeMode
Typ:  AltitudeMode optional
Domyślnie: AltitudeMode.ABSOLUTE
Określa sposób interpretacji komponentów wysokości we współrzędnych.
Atrybut HTML:
  • <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
coordinates
Uporządkowana sekwencja współrzędnych linii łamanej. W niektórych trybach wysokość jest ignorowana, więc jest opcjonalna.
drawsOccludedSegments
Typ:  boolean optional
Domyślnie: false
Określa, czy części polilinii, które mogą być zasłonięte, mają być rysowane. Linie łamane mogą być zasłonięte przez geometrię mapy (np. budynki).
Atrybut HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
Typ:  boolean optional
Domyślnie: false
Określa, czy polilinia ma być połączona z podłożem. Aby wyciągnąć linię łamaną, wartość parametru altitudeMode musi wynosić RELATIVE_TO_GROUND lub ABSOLUTE.
Atrybut HTML:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
Typ:  boolean optional
Domyślnie: false
Gdy jest włączona opcja true, krawędzie polilinii są interpretowane jako geodezyjne i będą podążać za krzywizną Ziemi. Gdy false, krawędzie polilinii są renderowane jako linie proste w przestrzeni ekranu.
Atrybut HTML:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
Typ:  string optional
Kolor zewnętrzny. Obsługiwane są wszystkie kolory CSS3.
Atrybut HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
Typ:  number optional
Szerokość zewnętrzna mieści się w zakresie od 0.0 do 1.0. Jest to procent strokeWidth.
Atrybut HTML:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
strokeColor
Typ:  string optional
Kolor konturu. Obsługiwane są wszystkie kolory CSS3.
Atrybut HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
Typ:  number optional
Szerokość linii w pikselach.
Atrybut HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Typ:  number optional
wartość zIndex w porównaniu z innymi wielokątami;
Atrybut HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-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.
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.

Polyline3DElementOptions interfejs

google.maps.maps3d.Polyline3DElementOptionsinterfejs

Obiekt Polyline3DElementOptions używany do definiowania właściwości, które można ustawić w obiekcie Polyline3DElement.
altitudeMode optional
Typ:  AltitudeMode optional
Zobacz Polyline3DElement.altitudeMode.
coordinates optional
Zobacz Polyline3DElement.coordinates.
drawsOccludedSegments optional
Typ:  boolean optional
Zobacz Polyline3DElement.drawsOccludedSegments.
extruded optional
Typ:  boolean optional
Zobacz Polyline3DElement.extruded.
geodesic optional
Typ:  boolean optional
Zobacz Polyline3DElement.geodesic.
outerColor optional
Typ:  string optional
Zobacz Polyline3DElement.outerColor.
outerWidth optional
Typ:  number optional
Zobacz Polyline3DElement.outerWidth.
strokeColor optional
Typ:  string optional
Zobacz Polyline3DElement.strokeColor.
strokeWidth optional
Typ:  number optional
Zobacz Polyline3DElement.strokeWidth.
zIndex optional
Typ:  number optional
Zobacz Polyline3DElement.zIndex.

Polygon3DElement class

google.maps.maps3d.Polygon3DElement zajęcia

Wielokąt 3D (np. linia łamana 3D) definiuje serię połączonych współrzędnych w uporządkowanej sekwencji. Wielokąty tworzą zamkniętą pętlę i określają wypełniony region.

Element niestandardowy:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs Polygon3DElementOptions.

Dostęp przez połączenie pod numer const {Polygon3DElement} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
Polygon3DElement
Polygon3DElement([options])
Parametry: 
Tworzy element Polygon3DElement z określonymi opcjami.
altitudeMode
Typ:  AltitudeMode optional
Domyślnie: AltitudeMode.ABSOLUTE
Określa sposób interpretacji komponentów wysokości we współrzędnych.
Atrybut HTML:
  • <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments
Typ:  boolean optional
Domyślnie: false
Określa, czy części wielokąta, które mogą być zasłonięte, mają być rysowane. Wielokąty mogą być zasłonięte przez geometrię mapy (np. budynki).
Atrybut HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Typ:  boolean optional
Domyślnie: false
Określa, czy wielokąt ma być połączony z podłożem. Aby wyciągnąć wielokąt, wartość altitudeMode musi wynosić RELATIVE_TO_GROUND lub ABSOLUTE.
Atrybut HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
Typ:  string optional
Kolor wypełnienia. Obsługiwane są wszystkie kolory CSS3.
Atrybut HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
Typ:  boolean optional
Domyślnie: false
Gdy jest włączona opcja true, krawędzie wielokąta są interpretowane jako geodezyjne i podążają za krzywizną Ziemi. Gdy false, krawędzie wielokąta są renderowane jako linie proste w przestrzeni ekranu.
Atrybut HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
Uporządkowana sekwencja współrzędnych, która wyznacza zamkniętą pętlę. W przeciwieństwie do polilinii wielokąt może składać się z co najmniej jednej ścieżki, które tworzą w nim wiele wycięć.
outerCoordinates
Uporządkowana sekwencja współrzędnych, która wyznacza zamkniętą pętlę. W niektórych trybach wysokość jest ignorowana, więc jest opcjonalna.
strokeColor
Typ:  string optional
Kolor konturu. Obsługiwane są wszystkie kolory CSS3.
Atrybut HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
Typ:  number optional
Szerokość linii w pikselach.
Atrybut HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Typ:  number optional
wartość zIndex w porównaniu z innymi wielokątami;
Atrybut HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-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.
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.

Polygon3DElementOptions interfejs

google.maps.maps3d.Polygon3DElementOptionsinterfejs

Obiekt Polygon3DElementOptions służący do definiowania właściwości, które można ustawić w elemencie Polygon3DElement.
altitudeMode optional
Typ:  AltitudeMode optional
Zobacz Polygon3DElement.altitudeMode.
drawsOccludedSegments optional
Typ:  boolean optional
Zobacz Polygon3DElement.drawsOccludedSegments.
extruded optional
Typ:  boolean optional
Zobacz Polygon3DElement.extruded.
fillColor optional
Typ:  string optional
Zobacz Polygon3DElement.fillColor.
geodesic optional
Typ:  boolean optional
Zobacz Polygon3DElement.geodesic.
innerCoordinates optional
Zobacz Polygon3DElement.innerCoordinates.
outerCoordinates optional
Zobacz Polygon3DElement.outerCoordinates.
strokeColor optional
Typ:  string optional
Zobacz Polygon3DElement.strokeColor.
strokeWidth optional
Typ:  number optional
Zobacz Polygon3DElement.strokeWidth.
zIndex optional
Typ:  number optional
Zobacz Polygon3DElement.zIndex.

AltitudeMode stałe

google.maps.maps3d.AltitudeMode stałe

Określa sposób interpretacji komponentów wysokości we współrzędnych.

Dostęp przez połączenie pod numer const {AltitudeMode} = await google.maps.importLibrary("maps3d").
 Zobacz Biblioteki w Maps JavaScript API.
ABSOLUTE Umożliwia określanie obiektów względem średniego poziomu morza. Oznacza to również, że jeśli poziom szczegółowości terenu pod obiektem ulegnie zmianie, jego położenie bezwzględne pozostanie takie samo.
CLAMP_TO_GROUND Umożliwia wyrażanie obiektów umieszczonych na ziemi. Pozostaną one na poziomie gruntu, niezależnie od podanej wysokości. Jeśli obiekt znajduje się nad dużym akwenem, zostanie umieszczony na poziomie morza.
RELATIVE_TO_GROUND Umożliwia wyrażanie obiektów w odniesieniu do powierzchni gruntu. Jeśli poziom szczegółowości terenu się zmieni, położenie obiektu względem podłoża pozostanie stałe. Nad wodą wysokość będzie interpretowana jako wartość w metrach nad poziomem morza.
RELATIVE_TO_MESH Umożliwia wyrażanie obiektów w odniesieniu do najwyższego punktu powierzchni gruntu, budynku lub wody. Gdy samolot znajduje się nad wodą, będzie to powierzchnia wody, a gdy nad terenem – powierzchnia budynku (jeśli jest) lub powierzchnia gruntu (jeśli nie ma budynków).