Marker3DElement 類別
google.maps.maps3d.Marker3DElement
class
在 3D 地圖上顯示位置。請注意,必須設定 position,系統才會顯示 Marker3DElement。
自訂元素:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" position="lat,lng" size-preserved z-index="number"></gmp-marker-3d>
這個類別會擴充 HTMLElement。
這個類別會實作 Marker3DElementOptions。
呼叫 const {Marker3DElement} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Marker3DElement |
Marker3DElement([options])參數:
使用指定選項建立 Marker3DElement。 |
屬性 | |
|---|---|
altitudeMode |
類型:
AltitudeMode optional指定位置的高度元件解讀方式。
HTML 屬性:
|
collisionBehavior |
類型:
CollisionBehavior optional列舉,指定 Marker3DElement 與其他 Marker3DElement 或底圖標籤衝突時應呈現的行為。
HTML 屬性:
|
drawsWhenOccluded |
類型:
boolean optional預設值:
false指定是否要在標記遭到遮擋時繪製標記。標記可能會被地圖幾何圖形 (例如建築物) 遮擋。
HTML 屬性:
|
extruded |
類型:
boolean optional預設值:
false指定是否要將標記連接至地面。如要凸出標記,
altitudeMode 必須是 RELATIVE_TO_GROUND 或 ABSOLUTE。HTML 屬性:
|
label |
類型:
string optional這個標記要顯示的文字。
HTML 屬性:
|
position |
類型:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional標記尖端的位置。在某些模式中,系統會忽略高度,因此可不提供。
HTML 屬性:
|
sizePreserved |
類型:
boolean optional預設值:
false指定這個標記是否應保持大小,無論與相機的距離為何。根據預設,標記會根據與攝影機/傾斜角度的距離縮放。
HTML 屬性:
|
zIndex |
類型:
number optional與其他標記相比的 zIndex。
HTML 屬性:
|
運算單元 | |
|---|---|
default |
直接新增至 Marker3DElement 的任何自訂元素都會加入版位,但只有 HTMLImageElement、SVGElement 和 PinElement 類型的元素會用於繪製標記,其他元素則會遭到忽略。HTMLImageElement 和 SVGElement 必須先包裝在 <template> 元素中,才能指派給 Marker3DElement 的預設版位。圖片和 SVG 目前會先經過光柵化,然後才在 3D 場景中算繪,因此嵌入 SVG 的自訂 HTML 或新增至圖片的 CSS 類別不會套用,且在畫面上顯示標記時可能不會反映。 |
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數:
傳回值:
void設定函式,每當指定事件傳送至目標時,系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數:
傳回值:
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
Marker3DElementOptions 介面
google.maps.maps3d.Marker3DElementOptions
介面
Marker3DElementOptions 物件,用於定義可在 Marker3DElement 上設定的屬性。
屬性 | |
|---|---|
altitudeMode optional |
類型:
AltitudeMode optional詳情請參閱《 Marker3DElement.altitudeMode》。 |
collisionBehavior optional |
類型:
CollisionBehavior optional |
drawsWhenOccluded optional |
類型:
boolean optional |
extruded optional |
類型:
boolean optional詳情請參閱《 Marker3DElement.extruded》。 |
label optional |
類型:
string optional詳情請參閱《 Marker3DElement.label》。 |
position optional |
類型:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional詳情請參閱《 Marker3DElement.position》。 |
sizePreserved optional |
類型:
boolean optional詳情請參閱《 Marker3DElement.sizePreserved》。 |
zIndex optional |
類型:
number optional詳情請參閱《 Marker3DElement.zIndex》。 |
Marker3DInteractiveElement 類別
google.maps.maps3d.Marker3DInteractiveElement
class
在 3D 地圖上顯示位置。請注意,必須設定 position,系統才會顯示 Marker3DInteractiveElement。與 Marker3DElement 不同,Marker3DInteractiveElement 會收到 gmp-click 事件。
自訂元素:
<gmp-marker-3d-interactive gmp-popover-target="popover-id" title="string"></gmp-marker-3d-interactive>
這個類別會擴充 Marker3DElement。
這個類別會實作 Marker3DInteractiveElementOptions。
呼叫 const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Marker3DInteractiveElement |
Marker3DInteractiveElement([options])參數:
使用指定選項建立 Marker3DInteractiveElement。 |
屬性 | |
|---|---|
gmpPopoverTargetElement |
類型:
PopoverElement optional設定後,只要點選這個標記,就會開啟彈出式元素。
HTML 屬性:
|
title |
類型:
string滑鼠游標懸停效果文字。如果提供無障礙文字 (例如用於螢幕閱讀器),系統會將該文字新增至
Marker3DInteractiveElement,並使用提供的值。HTML 屬性:
|
繼承:
altitudeMode、collisionBehavior、drawsWhenOccluded、extruded、label、position、sizePreserved、zIndex
| |
運算單元 | |
|---|---|
default |
直接新增至 Marker3DInteractiveElement 的任何自訂元素都會插入,但只有 PinElement 類型的元素會用於繪製標記,其他元素則會忽略。 |
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數:
傳回值:
void設定函式,每當指定事件傳送至目標時,系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數:
傳回值:
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
事件 | |
|---|---|
gmp-click |
function(clickEvent)引數:
使用者點選 Marker3DInteractiveElement 元素時,系統會觸發這個事件。 |
Marker3DInteractiveElementOptions 介面
google.maps.maps3d.Marker3DInteractiveElementOptions
介面
Marker3DInteractiveElementOptions 物件,用於定義可在 Marker3DInteractiveElement 上設定的屬性。
這個介面會擴充 Marker3DElementOptions。
屬性 | |
|---|---|
gmpPopoverTargetElement optional |
類型:
PopoverElement optional |
title optional |
類型:
string optional詳情請參閱《 Marker3DInteractiveElement.title》。 |
繼承:
altitudeMode、collisionBehavior、drawsWhenOccluded、extruded、label、position、sizePreserved、zIndex
| |
Model3DElement 類別
google.maps.maps3d.Model3DElement
class
可轉譯 gLTF 模型的 3D 模型。請注意,您必須設定 position 和 src,系統才會顯示 Model3DElement。
應支援 gLTF PBR 的核心屬性。目前不支援任何擴充功能或擴充功能屬性。
自訂元素:
<gmp-model-3d altitude-mode="absolute" orientation="heading,tilt,roll" position="lat,lng" scale="number" src="url"></gmp-model-3d>
這個類別會擴充 HTMLElement。
這個類別會實作 Model3DElementOptions。
呼叫 const {Model3DElement} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Model3DElement |
Model3DElement([options])參數:
使用指定選項建立 Model3DElement。 |
屬性 | |
|---|---|
altitudeMode |
類型:
AltitudeMode optional指定位置高度的解讀方式。
HTML 屬性:
|
orientation |
類型:
Orientation3D|Orientation3DLiteral optional說明 3D 模型座標系統的旋轉角度,以便將模型放置在 3D 地圖上。
系統會按照下列順序對模型套用旋轉:滾動、傾斜,然後是航向。 HTML 屬性:
|
position |
類型:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional設定
Model3DElement 的位置。在某些模式中,系統會忽略高度,因此可不提供。HTML 屬性:
|
scale |
類型:
number|Vector3D|Vector3DLiteral optional預設值:
1在模型的座標空間中,沿著 x、y 和 z 軸縮放模型。
HTML 屬性:
|
src |
類型:
string|URL optional指定 3D 模型的網址。目前僅支援
.glb 格式的模型。所有相對 HTTP 網址都會解析為對應的絕對網址。 請注意,如果 .glb 模型檔案託管在與主要應用程式不同的網站或伺服器上,請務必設定正確的 CORS HTTP 標頭。這樣一來,應用程式就能安全地存取其他網域的模型檔案。HTML 屬性:
|
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數:
傳回值:
void設定函式,每當指定事件傳送至目標時,系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數:
傳回值:
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
Model3DElementOptions 介面
google.maps.maps3d.Model3DElementOptions
介面
Model3DElementOptions 物件,用於定義可在 Model3DElement 上設定的屬性。
屬性 | |
|---|---|
altitudeMode optional |
類型:
AltitudeMode optional詳情請參閱《 Model3DElement.altitudeMode》。 |
orientation optional |
類型:
Orientation3D|Orientation3DLiteral optional詳情請參閱《 Model3DElement.orientation》。 |
position optional |
類型:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional詳情請參閱《 Model3DElement.position》。 |
scale optional |
類型:
number|Vector3D|Vector3DLiteral optional詳情請參閱《 Model3DElement.scale》。 |
src optional |
類型:
string|URL optional詳情請參閱《 Model3DElement.src》。 |
Model3DInteractiveElement 類別
google.maps.maps3d.Model3DInteractiveElement
class
可轉譯 gLTF 模型的 3D 模型。請注意,您必須設定 position 和 src,系統才會顯示 Model3DElement。
應支援 gLTF PBR 的核心屬性。目前不支援任何擴充功能或擴充功能屬性。
與 Model3DElement 不同,Model3DInteractiveElement 會收到 gmp-click 事件。
自訂元素:
<gmp-model-3d-interactive></gmp-model-3d-interactive>
這個類別會擴充 Model3DElement。
這個類別會實作 Model3DInteractiveElementOptions。
呼叫 const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Model3DInteractiveElement |
Model3DInteractiveElement([options])參數:
使用指定選項建立 Model3DInteractiveElement。 |
屬性 | |
|---|---|
繼承:
altitudeMode、orientation、position、scale、src |
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數:
傳回值:
void設定函式,每當指定事件傳送至目標時,系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數:
傳回值:
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
事件 | |
|---|---|
gmp-click |
function(clickEvent)引數:
使用者點選 Model3DInteractiveElement 元素時,系統會觸發這個事件。 |
Model3DInteractiveElementOptions 介面
google.maps.maps3d.Model3DInteractiveElementOptions
介面
Model3DInteractiveElementOptions 物件,用於定義可在 Model3DInteractiveElement 上設定的屬性。
這個介面會擴充 Model3DElementOptions。
屬性 | |
|---|---|
繼承:
altitudeMode、orientation、position、scale、src |
Polyline3DElement 類別
google.maps.maps3d.Polyline3DElement
class
3D 折線是 3D 地圖上連接線段的線性疊加層。
自訂元素:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>
這個類別會擴充 HTMLElement。
這個類別會實作 Polyline3DElementOptions。
呼叫 const {Polyline3DElement} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Polyline3DElement |
Polyline3DElement([options])參數:
使用指定選項建立 Polyline3DElement。 |
屬性 | |
|---|---|
altitudeMode |
類型:
AltitudeMode optional指定座標中高度元件的解讀方式。
HTML 屬性:
|
drawsOccludedSegments |
類型:
boolean optional預設值:
false指定是否要繪製可能遭到遮蔽的折線部分。折線可能會被地圖幾何圖形 (例如建築物) 遮擋。
HTML 屬性:
|
extruded |
類型:
boolean optional預設值:
false指定是否要將折線連接至地面。如要擠出折線,
altitudeMode 必須是 RELATIVE_TO_GROUND 或 ABSOLUTE。HTML 屬性:
|
geodesic |
類型:
boolean optional預設值:
false如果設為
true,折線邊緣會解讀為測地線,並沿著地球曲率繪製。如果設為 false,折線邊緣會在螢幕空間中算繪為直線。HTML 屬性:
|
outerColor |
類型:
string optional外圈顏色。系統支援所有 CSS3 顏色。
HTML 屬性:
|
outerWidth |
類型:
number optional外寬介於
0.0 和 1.0 之間。這是strokeWidth的百分比。HTML 屬性:
|
path |
類型:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional折線座標的排列順序。在某些模式中,系統會忽略高度,因此可不提供。
HTML 屬性:
|
strokeColor |
類型:
string optional筆觸色彩。系統支援所有 CSS3 顏色。
HTML 屬性:
|
strokeWidth |
類型:
number optional筆觸寬度 (以像素為單位)。
HTML 屬性:
|
zIndex |
類型:
number optional和其他多邊形比較的 zIndex。
HTML 屬性:
|
|
類型:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional折線座標的排列順序。在某些模式中,系統會忽略高度,因此可不提供。 |
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數:
傳回值:
void設定函式,每當指定事件傳送至目標時,系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數:
傳回值:
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
Polyline3DElementOptions 介面
google.maps.maps3d.Polyline3DElementOptions
介面
Polyline3DElementOptions 物件,用於定義可在 Polyline3DElement 上設定的屬性。
屬性 | |
|---|---|
altitudeMode optional |
類型:
AltitudeMode optional詳情請參閱《 Polyline3DElement.altitudeMode》。 |
coordinates optional |
類型:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional詳情請參閱《 》。 |
drawsOccludedSegments optional |
類型:
boolean optional |
extruded optional |
類型:
boolean optional詳情請參閱《 Polyline3DElement.extruded》。 |
geodesic optional |
類型:
boolean optional詳情請參閱《 Polyline3DElement.geodesic》。 |
outerColor optional |
類型:
string optional詳情請參閱《 Polyline3DElement.outerColor》。 |
outerWidth optional |
類型:
number optional詳情請參閱《 Polyline3DElement.outerWidth》。 |
strokeColor optional |
類型:
string optional詳情請參閱《 Polyline3DElement.strokeColor》。 |
strokeWidth optional |
類型:
number optional詳情請參閱《 Polyline3DElement.strokeWidth》。 |
zIndex optional |
類型:
number optional詳情請參閱《 Polyline3DElement.zIndex》。 |
Polyline3DInteractiveElement 類別
google.maps.maps3d.Polyline3DInteractiveElement
class
3D 折線是 3D 地圖上連接線段的線性疊加層。與 Polyline3DElement 不同,Polyline3DInteractiveElement 會收到 gmp-click 事件。
自訂元素:
<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>
這個類別會擴充 Polyline3DElement。
這個類別會實作 Polyline3DInteractiveElementOptions。
呼叫 const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Polyline3DInteractiveElement |
Polyline3DInteractiveElement([options])參數:
使用指定選項建立 Polyline3DInteractiveElement。 |
屬性 | |
|---|---|
繼承:
altitudeMode、drawsOccludedSegments、extruded、geodesic、outerColor、outerWidth、path、strokeColor、strokeWidth、zIndex、
|
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數:
傳回值:
void設定函式,每當指定事件傳送至目標時,系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數:
傳回值:
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
事件 | |
|---|---|
gmp-click |
function(clickEvent)引數:
使用者點選 Polyline3DInteractiveElement 元素時,系統會觸發這個事件。 |
Polyline3DInteractiveElementOptions 介面
google.maps.maps3d.Polyline3DInteractiveElementOptions
介面
Polyline3DInteractiveElementOptions 物件,用於定義可在 Polyline3DInteractiveElement 上設定的屬性。
這個介面會擴充 Polyline3DElementOptions。
屬性 | |
|---|---|
繼承:
altitudeMode、coordinates、drawsOccludedSegments、extruded、geodesic、outerColor、outerWidth、strokeColor、strokeWidth、zIndex
|
Polygon3DElement 類別
google.maps.maps3d.Polygon3DElement
class
3D 多邊形 (例如 3D 折線) 會定義一系列依序排列的相連座標。此外,多邊形會形成封閉迴圈,並定義填滿區域。
自訂元素:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>
這個類別會擴充 HTMLElement。
這個類別會實作 Polygon3DElementOptions。
呼叫 const {Polygon3DElement} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Polygon3DElement |
Polygon3DElement([options])參數:
使用指定選項建立 Polygon3DElement。 |
屬性 | |
|---|---|
altitudeMode |
類型:
AltitudeMode optional指定座標中高度元件的解讀方式。
HTML 屬性:
|
drawsOccludedSegments |
類型:
boolean optional預設值:
false指定是否繪製多邊形可能被遮擋的部分。多邊形可能會被地圖幾何圖形 (例如建築物) 遮擋。
HTML 屬性:
|
extruded |
類型:
boolean optional預設值:
false指定是否要將多邊形連接至地面。如要擠出多邊形,
altitudeMode 必須是 RELATIVE_TO_GROUND 或 ABSOLUTE。HTML 屬性:
|
fillColor |
類型:
string optional填色。系統支援所有 CSS3 顏色。
HTML 屬性:
|
geodesic |
類型:
boolean optional預設值:
false如果設為
true,多邊形的邊緣會解讀為測地線,並沿著地球曲率繪製。如果設為 false,多邊形的邊緣會在螢幕空間中轉譯為直線。HTML 屬性:
|
innerPaths |
類型:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional指定閉合迴圈的座標順序。與折線不同,多邊形可能由一或多個路徑組成,在多邊形內建立多個切口。 |
path |
類型:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional指定閉合迴圈的座標順序。在某些模式中,系統會忽略高度,因此可不提供。
HTML 屬性:
|
strokeColor |
類型:
string optional筆觸色彩。系統支援所有 CSS3 顏色。
HTML 屬性:
|
strokeWidth |
類型:
number optional筆觸寬度 (以像素為單位)。
HTML 屬性:
|
zIndex |
類型:
number optional和其他多邊形比較的 zIndex。
HTML 屬性:
|
|
類型:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional指定閉合迴圈的座標順序。在某些模式中,系統會忽略高度,因此可不提供。 |
|
類型:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional指定閉合迴圈的座標順序。與折線不同,多邊形可能由一或多個路徑組成,在多邊形內建立多個切口。 |
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數:
傳回值:
void設定函式,每當指定事件傳送至目標時,系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數:
傳回值:
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
Polygon3DElementOptions 介面
google.maps.maps3d.Polygon3DElementOptions
介面
Polygon3DElementOptions 物件,用於定義可在 Polygon3DElement 上設定的屬性。
屬性 | |
|---|---|
altitudeMode optional |
類型:
AltitudeMode optional詳情請參閱《 Polygon3DElement.altitudeMode》。 |
drawsOccludedSegments optional |
類型:
boolean optional |
extruded optional |
類型:
boolean optional詳情請參閱《 Polygon3DElement.extruded》。 |
fillColor optional |
類型:
string optional詳情請參閱《 Polygon3DElement.fillColor》。 |
geodesic optional |
類型:
boolean optional詳情請參閱《 Polygon3DElement.geodesic》。 |
innerCoordinates optional |
類型:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral>|Iterable<LatLngLiteral>> optional |
outerCoordinates optional |
類型:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional |
strokeColor optional |
類型:
string optional詳情請參閱《 Polygon3DElement.strokeColor》。 |
strokeWidth optional |
類型:
number optional詳情請參閱《 Polygon3DElement.strokeWidth》。 |
zIndex optional |
類型:
number optional詳情請參閱《 Polygon3DElement.zIndex》。 |
Polygon3DInteractiveElement 類別
google.maps.maps3d.Polygon3DInteractiveElement
class
3D 多邊形 (例如 3D 折線) 會定義一系列依序排列的相連座標。此外,多邊形會形成封閉迴圈,並定義填滿區域。與 Polygon3DElement 不同,Polygon3DInteractiveElement 會收到 gmp-click 事件。
自訂元素:
<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>
這個類別會擴充 Polygon3DElement。
這個類別會實作 Polygon3DInteractiveElementOptions。
呼叫 const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Polygon3DInteractiveElement |
Polygon3DInteractiveElement([options])參數:
使用指定選項建立 Polygon3DInteractiveElement。 |
屬性 | |
|---|---|
繼承:
altitudeMode、drawsOccludedSegments、extruded、fillColor、geodesic、innerPaths、path、strokeColor、strokeWidth、zIndex、、
|
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數:
傳回值:
void設定函式,每當指定事件傳送至目標時,系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數:
傳回值:
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
事件 | |
|---|---|
gmp-click |
function(clickEvent)引數:
使用者點選 Polygon3DInteractiveElement 元素時,系統會觸發這個事件。 |
Polygon3DInteractiveElementOptions 介面
google.maps.maps3d.Polygon3DInteractiveElementOptions
介面
Polygon3DInteractiveElementOptions 物件,用於定義可在 Polygon3DInteractiveElement 上設定的屬性。
這個介面會擴充 Polygon3DElementOptions。
屬性 | |
|---|---|
繼承:
altitudeMode、drawsOccludedSegments、extruded、fillColor、geodesic、innerCoordinates、outerCoordinates、strokeColor、strokeWidth、zIndex
|
PopoverElement 類別
google.maps.maps3d.PopoverElement
class
用於顯示彈出式視窗的自訂 HTML 元素。外觀看起來像對話框,通常會與標記連結。
自訂元素:
<gmp-popover altitude-mode="absolute" auto-pan-disabled light-dismiss-disabled open position-anchor="lat,lng"></gmp-popover>
這個類別會擴充 HTMLElement。
這個類別會實作 PopoverElementOptions。
呼叫 const {PopoverElement} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
PopoverElement |
PopoverElement([options])參數:
|
屬性 | |
|---|---|
altitudeMode |
類型:
AltitudeMode optional指定位置的高度元件解讀方式。
HTML 屬性:
|
autoPanDisabled |
類型:
boolean optional預設值:
false如果設為 True,系統會在彈出式視窗開啟時,停用平移地圖功能,讓彈出式視窗完整顯示。
HTML 屬性:
|
lightDismissDisabled |
類型:
boolean optional預設值:
false指定是否要「輕觸關閉」這個彈出式視窗。「輕觸關閉」行為與設定
popover="auto" 屬性類似,該屬性是瀏覽器 Popover API 的一部分。HTML 屬性:
|
open |
類型:
boolean optional預設值:
false指定是否應開啟這個彈出式視窗。
HTML 屬性:
|
positionAnchor |
類型:
LatLngLiteral|LatLngAltitudeLiteral|Marker3DInteractiveElement|string optional顯示這個彈出式視窗的位置。如果彈出式視窗錨定至互動式標記,系統會改用標記的位置。
HTML 屬性:
|
運算單元 | |
|---|---|
default |
將插槽內容放在彈出式視窗的主要部分。 |
header |
將插槽內容放在彈出式視窗的標題部分。 |
CSS 屬性 | |
|---|---|
--gmp-popover-max-width |
彈出式視窗的最大寬度,不論內容寬度為何。 |
--gmp-popover-min-width |
彈出式視窗的最小寬度,不論內容寬度為何。使用這項屬性時,強烈建議將其設為小於地圖寬度的值 (以像素為單位)。 |
--gmp-popover-pixel-offset-x |
彈出式視窗頂端與地圖上錨定點之間的 X 軸偏移量 (以像素為單位)。 |
--gmp-popover-pixel-offset-y |
彈出式視窗頂端與地圖上錨定點之間的 Y 軸偏移量 (以像素為單位)。 |
background-color |
彈出式視窗的背景顏色。詳情請參閱 background-color 說明文件。請注意,預設地點彈出式視窗也會受到這項屬性的影響。在自訂彈出式視窗中使用指定的 CSS 類別或內嵌樣式,避免為預設地點彈出式視窗設定樣式。 |
border-radius |
彈出式視窗的邊框半徑。詳情請參閱 border-radius 說明文件。請注意,預設地點彈出式視窗也會受到這項屬性的影響。在自訂彈出式視窗中使用指定的 CSS 類別或內嵌樣式,避免為預設地點彈出式視窗設定樣式。 |
box-shadow |
彈出式視窗的 box-shadow。詳情請參閱 box-shadow 說明文件。請注意,預設地點彈出式視窗也會受到這項屬性的影響。在自訂彈出式視窗中使用指定的 CSS 類別或內嵌樣式,避免為預設地點彈出式視窗設定樣式。 |
color-scheme |
指出這個彈出式視窗可採用的色彩配置。詳情請參閱 color-scheme 說明文件。如未指定,系統會預設為使用者的色彩配置偏好設定。 |
padding |
彈出式視窗的邊框間距。詳情請參閱 padding 說明文件。請注意,預設地點彈出式視窗也會受到這項屬性的影響。在自訂彈出式視窗中使用指定的 CSS 類別或內嵌樣式,避免為預設地點彈出式視窗設定樣式。 |
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數:
傳回值:
void設定函式,每當指定事件傳送至目標時,系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數:
傳回值:
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
PopoverElementOptions 介面
google.maps.maps3d.PopoverElementOptions
介面
PopoverElementOptions 物件,用於定義可在 PopoverElement 上設定的屬性。
屬性 | |
|---|---|
altitudeMode optional |
類型:
AltitudeMode optional詳情請參閱《 PopoverElement.altitudeMode》。 |
autoPanDisabled optional |
類型:
boolean optional詳情請參閱《 PopoverElement.autoPanDisabled》。 |
lightDismissDisabled optional |
類型:
boolean optional |
open optional |
類型:
boolean optional詳情請參閱《 PopoverElement.open》。 |
positionAnchor optional |
類型:
LatLngLiteral|LatLngAltitudeLiteral|string|Marker3DInteractiveElement optional詳情請參閱《 PopoverElement.positionAnchor》。 |
AltitudeMode 常數
google.maps.maps3d.AltitudeMode
常數
指定座標中高度元件的解讀方式。
呼叫 const {AltitudeMode} = await google.maps.importLibrary("maps3d") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
常數 | |
|---|---|
ABSOLUTE |
可表示相對於平均海平面的物件。這也表示,如果物件下方的地形詳細程度有所變更,物件的絕對位置仍會維持不變。 |
CLAMP_TO_GROUND |
可表示放置在地上的物件。無論提供的高度為何,都會沿著地形保持在地面。如果物件位於主要水體上方,則會放置在海平面上。 |
RELATIVE_TO_GROUND |
可相對於地面表示物件。如果地形細節層次改變,物件相對於地面的位置會保持不變。如果是在水面上,海拔高度會解讀為高於海平面的公尺值。 |
RELATIVE_TO_MESH |
可相對於地面、建築物和水面的最高點,表示物件。如果是在水面上,則為水面;如果是在地形上,則為建築物表面 (如有) 或地面 (如無建築物)。 |