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 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 w określonych granicach współrzędnych lat/lng. Pamiętaj, że obiekty poza obszarem nadal są renderowane. Ograniczenia mogą dotyczyć zarówno długości, jak i szerokości geograficznej. Mogą też ograniczać tylko długość i szerokość geograficzną. 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 tylko długości geograficznej użyj szerokości geograficznej północnej i południowej odpowiednio z 90 i -90.
center
Środek mapy podany jako LatLngAltitude, gdzie wysokość jest wyrażona w metrach nad poziomem morza. Pamiętaj, że nie musi to być miejsce, w którym znajduje się kamera, ponieważ pole range wpływa na odległość kamery od środka mapy. Jeśli nie jest skonfigurowana, 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
Wartość domyślna: false
Gdy true, wszystkie domyślne przyciski interfejsu są wyłączone. Nie wyłącza klawiatury ani sterowania gestami.
Atrybut HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
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 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. 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 (obrócenia) mapy. Prawidłowa wartość mieści się w zakresie od 0 do 360 stopni. minHeading i maxHeading to przedział <= 360 stopni, w którym dozwolone są gesty nagłówka. 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 widzenia w stopniach. Aby uniknąć niejasności, gdy nie ma przechylenia, każde obrót jest interpretowane 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 nachylenie 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 wartości capture i passive.
Zwracana wartość:  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 porusza 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 obiektu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Zwracana wartość:  void
Usuwa z miejsca docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą addEventListener. Patrz removeEventListener
stopCameraAnimation
stopCameraAnimation()
Parametry: brak
Zwracana wartość:  brak
Ta metoda zatrzymuje wszystkie uruchomione animacje lotu. 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ć lub zatrzymywać dopiero po wczytaniu mapy w minimalnym zakresie. Metoda powraca 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 po zmianie właściwości nagłówka 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ść pochylenia elementu Map3DElement.

Map3DElementOptions: interfejs

Interfejs google.maps.maps3d.Map3DElementOptions

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 patrzeć 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ślny.

Interfejs FlyToAnimationOptions

google.maps.maps3d.FlyToAnimationOptionsinterfejs

Opcje dostosowywania animacji FlyCameraTo.

endCamera
Miejsce, w którym aparat powinien być skierowany na koniec 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. Obiekt kamery może być dowolnym obiektem, który ma położenie kamery, np. bieżący stan mapy lub żądany stan animacji w przyszłości.

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 wyświetla się w drzewie DOM.

Ta klasa rozszerza zakres Event.

Dostęp przez połączenie telefoniczne pod numer 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 pod numer 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 bardziej niższych poziomach zwracane będą 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 pod numer const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w Maps JavaScript API.

placeId
Typ:  string
Identyfikator miejsca elementu mapy.
Podane z poziomu klasy: position
fetchPlace
fetchPlace()
Parametry: brak
Zwracana wartość:  Promise<Place>
Pobiera Place dla tego identyfikatora miejsca. W powstałym obiekcie Place zostanie uzupełniona właściwość id. Dodatkowe pola można następnie wysyłać za pomocą Place.fetchFields() w zależności od normalnego włączenia interfejsu Places API i rozliczeń. Obietnica jest odrzucana, jeśli wystąpił błąd podczas pobierania Place.

Klasa Marker3DElement

google.maps.maps3d.Marker3DElement zajęcia

Pokazuje położenie na mapie 3D. Pamiętaj, że aby element Marker3DElement się wyświetlił, musisz skonfigurować atrybut 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 pod numer 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 sposób interpretacji komponentu wysokości położenia.
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
Wartość domyślna: false
Określa, czy ten znacznik ma być rysowany, gdy jest ukryty. 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 można było wyciągnąć znacznik, altitudeMode musi mieć 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/pochylenia.
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 Marker3DElement zostaną umieszczone w ramkach, ale do rysowania znaczników będą używane tylko elementy typu HTMLImageElement, SVGElementPinElement. Pozostałe elementy zostaną zignorowane. Przed przypisaniem 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.
Zwracana wartość:  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 obiektu zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Zwracana wartość:  void
Usuwa z miejsca docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą addEventListener. Zobacz 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

Pokazuje położenie na mapie 3D. Pamiętaj, że aby opcja Marker3DInteractiveElement była widoczna, musisz ustawić opcję position. W przeciwieństwie do reguły Marker3DElement Marker3DInteractiveElement otrzymuje 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 pod numer const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w interfejsie 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 wartości capture i passive.
Zwracana wartość:  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: 
  • typestring ciąg znaków określający typ zdarzenia, dla którego ma zostać usunięty detektor zdarzeń.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego obiektu zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Zwracana wartość:  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. Pamiętaj, że aby Model3DElement się wyświetlał, muszą być skonfigurowane właściwości position i src.

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

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 pod numer 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 ustawienia modelu na mapie 3D.

Rotacje są stosowane do modelu w 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
Wartość domyślna: 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ą przekształcone w odpowiednie bezwzględne adresy URL.

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 CORS HTTP. 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.
Zwracana wartość:  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 zdarzeń modułu obsługi zdarzeń, który ma zostać usunięty z celu zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Zwracana wartość:  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 elemencie 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 zajęcia

Linia łamana 3D to liniowy nakładka połączonych segmentó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 pod numer const {Polyline3DElement} = await google.maps.importLibrary("maps3d"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Polyline3DElement
Polyline3DElement([options])
Parametry: 
Tworzy Polyline3DElement z określonymi opcjami.
altitudeMode
Typ:  AltitudeMode optional
Wartość domyślna: AltitudeMode.ABSOLUTE
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
Wartość domyślna: false
Określa, czy elementy linii łamanej, które mogły zostać ukryte, są rysowane. Polilinie 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 łamana ma zostać połączona z powierzchnią. 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
W przypadku funkcji true krawędzie linii łamanej są interpretowane jako geodezja i postępują zgodnie z krzywą kuli ziemskiej. Gdy false, krawędzie wielokąta 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. To jest 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 z uwzględnieniem wielkości liter, określający typ zdarzenia, które ma być nasłuchiwane.
  • 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.
Zwracana wartość:  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 obiektu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Zwracana wartość:  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 pod numer 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
Wartość domyślna: 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 wyciągnąć wielokąt, altitudeMode musi mieć 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
W przypadku wartości true krawędzie wielokąta są interpretowane jako geodezja i postępują zgodnie z krzywą kuli ziemskiej. W przypadku ustawienia false krawędzie wielokąta są renderowane na ekranie jako linie proste.
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.
Zwracana wartość:  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: 
  • typestring ciąg znaków określający typ zdarzenia, dla którego ma zostać usunięty detektor zdarzeń.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego obiektu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Zwracana wartość:  void
Usuwa z miejsca docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą 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

stałe: google.maps.maps3d.AltitudeMode

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

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

ABSOLUTE Umożliwia wyrażenie obiektów w odniesieniu do ś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 jest ustawiony nad większym akwenem, 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. Jeśli wysokość znajduje się nad wodą, wysokość zostanie zinterpretowana jako wartość w metrach nad poziomem morza.
RELATIVE_TO_MESH Umożliwia wyrażenie obiektów w odniesieniu do najwyższej powierzchni ziemi, budynku i 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).