3D Maps

Klasa Map3DElement

google.maps.maps3d.Map3DElement class

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>

Te zajęcia trwają HTMLElement.

Ta klasa implementuje Map3DElementOptions.

Dostęp przez połączenie telefoniczne const {Map3DElement} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

Map3DElement
Map3DElement([options])
Parametry: 
bounds
Po ustawieniu ogranicza pozycję kamery w określonych granicach szerokości i długości geograficznej. Pamiętaj, że obiekty poza obszarem nadal są renderowane. Granice mogą ograniczać zarówno długość, jak i szerokość geograficzną, albo tylko jedną z nich. W przypadku zakresów obejmujących tylko szerokość geograficzną użyj długości geograficznej zachodniej i wschodniej odpowiednio -180 i 180. W przypadku granic wyznaczonych tylko przez długość geograficzną użyj szerokości geograficznej północnej i południowej odpowiednio 90 i -90.
center
Środek mapy podany jako LatLngAltitude, gdzie wysokość jest wyrażona w metrach nad poziomem morza. Pamiętaj, że nie zawsze jest to miejsce, w którym znajduje się kamera, ponieważ pole range wpływa na odległość kamery od środka mapy. Jeśli nie zostanie ustawiony, domyślna wartość to {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>
defaultLabelsDisabled
Typ:  boolean optional
Domyślnie: false
Gdy true, domyślne etykiety map nie są renderowane.
Atrybut HTML:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
Typ:  boolean optional
Domyślnie: false
Gdy true, wszystkie domyślne przyciski interfejsu są wyłączone. Nie wyłącza sterowania za pomocą klawiatury ani gestów.
Atrybut HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Typ:  number optional
Kierunek na mapie, wyrażony w stopniach, gdzie kierunek na północ to 0. Gdy nie ma nachylenia, 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 poziomem morza, 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. minHeadingmaxHeading to interwał o długości <= 360 stopni, w którym będą dozwolone gesty dotyczące kierunku. minHeading = 180maxHeading = 90 umożliwią użycie nagłówka w [0, 90] i nagłówka w [180, 360]. minHeading = 90maxHeading = 180 umożliwią użycie 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 poziomem morza, 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. minHeadingmaxHeading to interwał o długości <= 360 stopni, w którym będą dozwolone gesty dotyczące kierunku. minHeading = 180maxHeading = 90 umożliwią użycie nagłówka w [0, 90] i nagłówka w [180, 360]. minHeading = 90maxHeading = 180 umożliwią użycie 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
Obrót kamery wokół wektora widoku wyrażony w stopniach. Aby uniknąć niejasności, gdy nie ma pochylenia, 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ę miałby pochylenie równe 0°. Wektor widoku skierowany od Ziemi miałby kąt nachylenia 180 stopni.
Atrybut HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków uwzględniający wielkość liter, który reprezentuje typ zdarzenia do nasłuchiwania.
  • listenerEventListener|EventListenerObject Obiekt, który odbiera powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|AddEventListenerOptions optional patrz opcje. Zdarzenia niestandardowe obsługują tylko capturepassive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener
flyCameraAround
flyCameraAround(options)
Parametry: 
Zwracana wartość:  brak
W tej metodzie kamera obraca się wokół danej lokalizacji przez określony czas, wykonując w tym czasie określonyą liczbę obrotów.

Domyślnie kamera obraca się zgodnie z ruchem wskazówek zegara. Jeśli podana liczba jest ujemna, kamera będzie się obracać w przeciwnym kierunku.

Metoda jest asynchroniczna, ponieważ animacje mogą się rozpocząć dopiero po załadowaniu mapy do minimalnego rozmiaru. Metoda zwraca wartość po uruchomieniu animacji.

Jeśli liczba rund wynosi 0, nie nastąpi żadne kręcenie, a animacja zakończy się natychmiast po rozpoczęciu.
flyCameraTo
flyCameraTo(options)
Parametry: 
Zwracana wartość:  brak
Ta metoda przesuwa kamerę parabolicznie z bieżącej pozycji do określonej pozycji końcowej w określonym czasie.

Metoda jest asynchroniczna, ponieważ animacje mogą się rozpocząć dopiero po załadowaniu mapy do minimalnego rozmiaru. Metoda zwraca wartość po uruchomieniu animacji.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestringCiąg znaków określający typ zdarzenia, dla którego ma zostać usunięty dekoder zdarzenia.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Wartość zwracana:  void
Usuwa z docelowego elementu detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Patrz removeEventListener
stopCameraAnimation
stopCameraAnimation()
Parametry: brak
Zwracana wartość:  brak
Ta metoda zatrzymuje każdą animację, która mogłaby być uruchomiona. Kamera pozostaje w tym samym miejscu, w którym była w trakcie animacji. Nie teleportuje się do punktu końcowego.

Metoda jest asynchroniczna, ponieważ animacje mogą się uruchamiać i zatrzymywać dopiero po załadowaniu mapy do minimalnego rozmiaru. Metoda zwraca wartość po zatrzymaniu animacji.
gmp-animationend
function(animationEndEvent)
Argumenty: 
  • animationEndEventEvent
To zdarzenie jest wywoływane po zakończeniu animacji przelotu. To zdarzenie przenika przez drzewo DOM.
gmp-centerchange
function(centerChangeEvent)
Argumenty: 
  • centerChangeEventEvent
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: 
  • headingChangeEventEvent
To zdarzenie jest wywoływane, gdy zmienia się właściwość heading elementu Map3DElement.
gmp-rangechange
function(rangeChangeEvent)
Argumenty: 
  • rangeChangeEventEvent
To zdarzenie jest wywoływane, gdy zmienia się wartość właściwości zakresu elementu Map3DElement.
gmp-rollchange
function(rollChangeEvent)
Argumenty: 
  • rollChangeEventEvent
To zdarzenie jest wywoływane, gdy zmienia się wartość właściwości roll elementu Map3DElement.
gmp-steadychange
function(steadyChangeEvent)
Argumenty: 
To zdarzenie jest wywoływane, gdy zmienia się stan stabilny Map3DElement.
gmp-tiltchange
function(tiltChangeEvent)
Argumenty: 
  • tiltChangeEventEvent
To zdarzenie jest wywoływane, gdy zmienia się właściwość nachylenia elementu Map3DElement.

Map3DElementOptions: interfejs

google.maps.maps3d.Map3DElementOptionsinterfejs

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

bounds optional
center optional
defaultLabelsDisabled optional
Typ:  boolean optional
defaultUIDisabled optional
Typ:  boolean optional
heading optional
Typ:  number optional
maxAltitude optional
Typ:  number optional
maxHeading optional
Typ:  number optional
maxTilt optional
Typ:  number optional
minAltitude optional
Typ:  number optional
minHeading optional
Typ:  number optional
minTilt optional
Typ:  number optional
range optional
Typ:  number optional
roll optional
Typ:  number optional
tilt optional
Typ:  number optional

FlyAroundAnimationOptions (interfejs)

google.maps.maps3d.FlyAroundAnimationOptionsinterfejs

Opcje dostosowywania animacji FlyCameraAround.

camera
Punkt centralny, na który powinna być skierowana kamera podczas animacji orbity. Pamiętaj, że kierunek na mapie 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 przedziale czasu. Parametr ten kontroluje ogólną prędkość obrotu. Podanie ujemnej wartości spowoduje, że kamera będzie się obracać w przeciwnym kierunku niż domyślnie w kierunku zgodnym z zegarzem.

FlyToAnimationOptions (interfejs)

google.maps.maps3d.FlyToAnimationOptionsinterfejs

Opcje dostosowywania animacji FlyCameraTo.

endCamera
Miejsce, na które ma wskazywać kamera 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.

Interfejs CameraOptions

google.maps.maps3d.CameraOptionsinterfejs

Obiekt CameraOptions służy do definiowania właściwości, które można ustawić w obiekcie Camera. Obiektem kamery może być wszystko, co ma pozycję kamery, np. bieżący stan mapy lub przyszły żądany stan animacji.

center optional
heading optional
Typ:  number optional
range optional
Typ:  number optional
roll optional
Typ:  number optional
tilt optional
Typ:  number optional

SteadyChangeEvent class

google.maps.maps3d.SteadyChangeEvent class

To zdarzenie jest tworzone na podstawie monitorowania stabilnego stanu Map3DElement. To zdarzenie przenika przez drzewo DOM.

Te zajęcia trwają Event.

Dostęp przez połączenie telefoniczne const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

isSteady
Typ:  boolean
Wskazuje, czy element Map3D jest stabilny (czyli czy wszystkie renderowanie bieżącej sceny zostało ukończone).

Klasa LocationClickEvent

google.maps.maps3d.LocationClickEvent class

To zdarzenie jest tworzone po kliknięciu elementu Map3DElement.

Te zajęcia trwają Event.

Dostęp przez połączenie telefoniczne const {LocationClickEvent} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

position
Typ:  LatLngAltitude optional
Szerokość/długość geograficzna/wysokość, która była pod kursorem w momencie wystąpienia zdarzenia. Pamiętaj, że na niższych poziomach zwracane są mniej dokładne dane. Gdy klikniesz powierzchnię wody z wyższej pozycji kamery, wartość wysokości może być zwrócona jako wysokość dna morskiego. To zdarzenie przenika przez drzewo DOM.

klasa PlaceClickEvent

google.maps.maps3d.PlaceClickEvent class

To zdarzenie jest tworzone po kliknięciu elementu Map3DElement.

Te zajęcia trwają LocationClickEvent.

Dostęp przez połączenie telefoniczne const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

placeId
Typ:  string
Identyfikator miejsca na mapie.
Podane z poziomu klasy: position
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 poprosić później, korzystając z interfejsu Place.fetchFields(), pod warunkiem, że interfejs Places API jest włączony i obsługiwany zgodnie z zasadami rozliczeń. Obietnica jest odrzucana, jeśli wystąpił błąd podczas pobierania Place.

Klasa Marker3DElement

google.maps.maps3d.Marker3DElement class

Wyświetla pozycję na mapie 3D. Pamiętaj, że aby opcja Marker3DElement była widoczna, musisz ustawić opcję 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>

Te zajęcia trwają HTMLElement.

Ta klasa implementuje Marker3DElementOptions.

Dostęp przez połączenie telefoniczne const {Marker3DElement} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

Marker3DElement
Marker3DElement([options])
Parametry: 
Tworzy Marker3DElement z określonymi opcjami.
altitudeMode
Typ:  AltitudeMode optional
Określa, jak interpretowany jest element 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
Wyliczenie określające, jak Marker3DElement powinien się zachowywać, gdy zderzy się z innym obiektem Marker3DElement lub 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ć wyświetlany, gdy jest zasłonięty. znacznik 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 wytłoczyć znacznik, w polu altitudeMode musi występować wartość RELATIVE_TO_GROUND lub ABSOLUTE.
Atrybut HTML:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
Typ:  string optional
Tekst wyświetlany przez ten znacznik.
Atrybut HTML:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
Lokalizacja wierzchołka znacznika. Wysokość jest ignorowana w niektórych trybach i jest opcjonalna.
sizePreserved
Typ:  boolean optional
Domyślnie: false
Określa, czy znacznik ma zachować swój rozmiar niezależnie od odległości od kamery. Domyślnie znacznik jest skalowany na podstawie odległości od kamery lub pochylenia.
Atrybut HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
Typ:  number optional
Z-indeks w porównaniu z innymi wskaźnikami.
Atrybut HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Wszystkie elementy niestandardowe dodane bezpośrednio do Marker3DElement zostaną umieszczone w ramkach, ale do rysowania znaczników będą używane tylko elementy typu HTMLImageElement, SVGElementPinElement. Pozostałe elementy zostaną zignorowane. Zanim zostaną przypisane do domyślnego slotu Marker3DElement, elementy
HTMLImageElementSVGElement muszą zostać zawinięte w element <template>.

Obecnie obrazy i pliki SVG są rastrowane przed wyrenderowaniem w scenie 3D, więc niestandardowy kod HTML umieszczony w klasach SVG lub CSS dodanych do obrazów nie zostanie zastosowany i może nie być widoczny, gdy znaczniki są wyświetlane na ekranie.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków uwzględniający wielkość liter, który reprezentuje typ zdarzenia do nasłuchiwania.
  • listenerEventListener|EventListenerObject Obiekt, który odbiera powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|AddEventListenerOptions optional patrz opcje. Zdarzenia niestandardowe obsługują tylko capturepassive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestringCiąg znaków określający typ zdarzenia, dla którego ma zostać usunięty dekoder zdarzenia.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Wartość zwracana:  void
Usuwa z docelowego elementu detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Patrz removeEventListener

Interfejs Marker3DElementOptions

google.maps.maps3d.Marker3DElementOptionsinterfejs

Obiekt Marker3DElementOptions służy do definiowania właściwości, które można ustawić w obiekcie Marker3DElement.

altitudeMode optional
Typ:  AltitudeMode optional
collisionBehavior optional
Typ:  CollisionBehavior optional
drawsWhenOccluded optional
Typ:  boolean optional
extruded optional
Typ:  boolean optional
label optional
Typ:  string optional
position optional
sizePreserved optional
Typ:  boolean optional
zIndex optional
Typ:  number optional

Klasa Marker3DInteractiveElement

google.maps.maps3d.Marker3DInteractiveElement class

Wyświetla pozycję na mapie 3D. Pamiętaj, że aby opcja Marker3DInteractiveElement była widoczna, musisz ustawić opcję position. W przeciwieństwie do Marker3DElement usługa Marker3DInteractiveElement odbiera zdarzenie gmp-click.

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

Te zajęcia trwają Marker3DElement.

Ta klasa implementuje Marker3DInteractiveElementOptions.

Dostęp przez połączenie telefoniczne const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Parametry: 
Tworzy Marker3DInteractiveElement z określonymi opcjami.
Uzyskane: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex
default
Wszystkie elementy niestandardowe dodane bezpośrednio do Marker3DInteractiveElement zostaną umieszczone w ramkach, ale do rysowania znaczników będą używane tylko elementy typu PinElement. Pozostałe elementy zostaną zignorowane.
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków uwzględniający wielkość liter, który reprezentuje typ zdarzenia do nasłuchiwania.
  • listenerEventListener|EventListenerObject Obiekt, który odbiera powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|AddEventListenerOptions optional patrz opcje. Zdarzenia niestandardowe obsługują tylko capturepassive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener
removeEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestringCiąg znaków określający typ zdarzenia, dla którego ma zostać usunięty dekoder zdarzenia.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Wartość zwracana:  void
Usuwa z docelowego elementu detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Patrz removeEventListener
gmp-click
function(clickEvent)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu elementu Marker3DInteractiveElement.

Interfejs Marker3DInteractiveElementOptions

google.maps.maps3d.Marker3DInteractiveElementOptionsinterfejs

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

Ten interfejs rozszerza Marker3DElementOptions.

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

Klasa Model3DElement

google.maps.maps3d.Model3DElement class

Model 3D, który umożliwia renderowanie modeli gLTF. Aby zasada Model3DElement była wyświetlana, musisz skonfigurować zasady positionsrc.

 Należy obsługiwać podstawowe właściwości gLTF PBR. Obecnie nie są obsługiwane żadne rozszerzenia ani właściwości rozszerzeń.

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

Te zajęcia trwają HTMLElement.

Ta klasa implementuje Model3DElementOptions.

Dostęp przez połączenie telefoniczne const {Model3DElement} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

Model3DElement
Model3DElement([options])
Parametry: 
Tworzy Model3DElement z określonymi opcjami.
altitudeMode
Typ:  AltitudeMode optional
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 obrót systemu współrzędnych modelu 3D w celu umieszczenia modelu na mapie 3D.

Rotacje są stosowane do modelu w tej kolejności: przechylenie, obrót i kierunek.
position
Ustawia pozycję Model3DElement. Wysokość jest ignorowana w niektórych trybach i 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.

 Wszelkie względne adresy URL HTTP zostaną zastąpione ich odpowiednikami bezwzględnymi.

Jeśli pliki modelu .glb są hostowane w innej witrynie lub na innym serwerze niż główna aplikacja, pamiętaj o skonfigurowaniu prawidłowych nagłówków 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: 
  • typestring ciąg znaków uwzględniający wielkość liter, który reprezentuje typ zdarzenia do nasłuchiwania.
  • listenerEventListener|EventListenerObject Obiekt, który odbiera powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|AddEventListenerOptions optional patrz opcje. Zdarzenia niestandardowe obsługują tylko capturepassive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestringCiąg znaków określający typ zdarzenia, dla którego ma zostać usunięty dekoder zdarzenia.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Wartość zwracana:  void
Usuwa z docelowego elementu detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Patrz removeEventListener

Interfejs Model3DElementOptions

google.maps.maps3d.Model3DElementOptionsinterfejs

Obiekt Model3DElementOptions służy do definiowania właściwości, które można ustawić w obiekcie Model3DElement.

altitudeMode optional
Typ:  AltitudeMode optional
orientation optional
position optional
scale optional
Typ:  number|Vector3D|Vector3DLiteral optional
src optional
Typ:  string|URL optional

Klasa Polyline3DElement

google.maps.maps3d.Polyline3DElement class

Linia złożona 3D to liniowe nakładanie połączonych odcinków linii 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>

Te zajęcia trwają HTMLElement.

Ta klasa implementuje Polyline3DElementOptions.

Dostęp przez połączenie telefoniczne const {Polyline3DElement} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

Polyline3DElement
Polyline3DElement([options])
Parametry: 
Tworzy Polyline3DElement z określonymi opcjami.
altitudeMode
Typ:  AltitudeMode optional
Określa, jak interpretować komponenty wysokości w 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. Wysokość jest ignorowana w niektórych trybach i jest opcjonalna.
drawsOccludedSegments
Typ:  boolean optional
Domyślnie: false
Określa, czy części łamany, które mogłyby być zasłonięte, mają być rysowane. Linie złożone 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 linia wielokąta ma być połączona z ziemią. Aby wytłoczyć linię łamaną, musisz ustawić parametr altitudeMode na wartość RELATIVE_TO_GROUND lub ABSOLUTE.
Atrybut HTML:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
Typ:  boolean optional
Domyślnie: false
Jeśli true, krawędzie wielokąta są interpretowane jako geodezyjne i naśladują krzywiznę Ziemi. Gdy false, krawędzie wielokąta są renderowane jako linie proste na ekranie.
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. 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ść obrysu w pikselach.
Atrybut HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Typ:  number optional
Z-index w porównaniu z innymi wielokątami.
Atrybut HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków uwzględniający wielkość liter, który reprezentuje typ zdarzenia do nasłuchiwania.
  • listenerEventListener|EventListenerObject Obiekt, który odbiera powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|AddEventListenerOptions optional patrz opcje. Zdarzenia niestandardowe obsługują tylko capturepassive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestringCiąg znaków określający typ zdarzenia, dla którego ma zostać usunięty dekoder zdarzenia.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Wartość zwracana:  void
Usuwa z docelowego elementu detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Patrz removeEventListener

Interfejs Polyline3DElementOptions

google.maps.maps3d.Polyline3DElementOptionsinterfejs

Obiekt Polyline3DElementOptions służy do definiowania właściwości, które można ustawić w obiekcie Polyline3DElement.

altitudeMode optional
Typ:  AltitudeMode optional
coordinates optional
drawsOccludedSegments optional
Typ:  boolean optional
extruded optional
Typ:  boolean optional
geodesic optional
Typ:  boolean optional
outerColor optional
Typ:  string optional
outerWidth optional
Typ:  number optional
strokeColor optional
Typ:  string optional
strokeWidth optional
Typ:  number optional
zIndex optional
Typ:  number optional

klasa Polygon3DElement

google.maps.maps3d.Polygon3DElement class

Wielokąt 3D (podobnie jak linia łamana 3D) definiuje serię połączonych ze sobą współrzędnych w uporządkowanej kolejności. Dodatkowo wielokąty tworzą zamkniętą pętlę i określają wypełniony obszar.

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>

Te zajęcia trwają HTMLElement.

Ta klasa implementuje Polygon3DElementOptions.

Dostęp przez połączenie telefoniczne const {Polygon3DElement} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

Polygon3DElement
Polygon3DElement([options])
Parametry: 
Tworzy Polygon3DElement z określonymi opcjami.
altitudeMode
Typ:  AltitudeMode optional
Określa, jak interpretować komponenty wysokości w 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łyby 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 ziemią. Aby wytłoczyć wielokąt, w polu altitudeMode musi występować wartość 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 true, krawędzie wielokąta są interpretowane jako geodezyjne i naśladują krzywiznę Ziemi. Gdy false, krawędzie wielokąta są renderowane jako proste linie 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 jednej lub większej liczby ścieżek, które tworzą w wielokącie wiele wycięć.
outerCoordinates
Uporządkowana sekwencja współrzędnych, która wyznacza zamkniętą pętlę. Wysokość jest ignorowana w niektórych trybach i 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ść obrysu w pikselach.
Atrybut HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Typ:  number optional
Z-index w porównaniu z innymi wielokątami.
Atrybut HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków uwzględniający wielkość liter, który reprezentuje typ zdarzenia do nasłuchiwania.
  • listenerEventListener|EventListenerObject Obiekt, który odbiera powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|AddEventListenerOptions optional patrz opcje. Zdarzenia niestandardowe obsługują tylko capturepassive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestringCiąg znaków określający typ zdarzenia, dla którego ma zostać usunięty dekoder zdarzenia.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Wartość zwracana:  void
Usuwa z docelowego elementu detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Patrz removeEventListener

Interfejs Polygon3DElementOptions

google.maps.maps3d.Polygon3DElementOptionsinterfejs

Obiekt Polygon3DElementOptions służy do definiowania właściwości, które można ustawić w obiekcie Polygon3DElement.

altitudeMode optional
Typ:  AltitudeMode optional
drawsOccludedSegments optional
Typ:  boolean optional
extruded optional
Typ:  boolean optional
fillColor optional
Typ:  string optional
geodesic optional
Typ:  boolean optional
innerCoordinates optional
outerCoordinates optional
strokeColor optional
Typ:  string optional
strokeWidth optional
Typ:  number optional
zIndex optional
Typ:  number optional

AltitudeMode constants

google.maps.maps3d.AltitudeMode stałe

Określa, jak interpretować komponenty wysokości w współrzędnych.

Dostęp przez połączenie telefoniczne const {AltitudeMode} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

ABSOLUTE Umożliwia wyrażanie wysokości obiektów względem średniego poziomu morza. Oznacza to też, że jeśli poziom szczegółów terenu pod obiektem ulegnie zmianie, jego bezwzględna pozycja pozostanie taka sama.
CLAMP_TO_GROUND Umożliwia wyrażanie obiektów umieszczonych na ziemi. Pozostaną one na poziomie gruntu, podążając za rzeźbą terenu, niezależnie od podanej wysokości. Jeśli obiekt znajduje się nad dużym zbiornikiem wodnym, zostanie umieszczony na poziomie morza.
RELATIVE_TO_GROUND Umożliwia wyrażanie obiektów względem powierzchni gruntu. Jeśli poziom szczegółów terenu ulegnie zmianie, położenie obiektu w relacji do podłoża pozostanie niezmienne. Nad wodą wysokość będzie interpretowana jako wartość w metrach nad poziomem morza.
RELATIVE_TO_MESH Umożliwia wyrażanie obiektów w relacji do najwyższej powierzchni gruntu, budynku lub wody. W przypadku wody będzie to powierzchnia wody, a w przypadku terenu – powierzchnia budynku (jeśli jest) lub powierzchnia gruntu (jeśli nie ma budynków).