Map3DElement 類別
google.maps.maps3d.Map3DElement
class
Map3DElement 是 3D 地圖檢視畫面的 HTML 介面。
自訂元素：
<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>
這個類別會擴充 HTMLElement。
這個類別會實作 Map3DElementOptions。
請呼叫 const {Map3DElement} = await google.maps.importLibrary("maps3d") 存取。請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Map3DElement |
Map3DElement([options])參數：
|
屬性 | |
|---|---|
bounds |
類型：
LatLngBounds|LatLngBoundsLiteral optional設定後，會將攝影機的位置限制在指定的經緯度邊界內。請注意，邊界外部的物件仍會算繪。邊界可以同時限制經度和緯度，也可以只限制其中一個。如要設定僅限緯度的邊界，請分別使用 -180 和 180 的西邊和東邊經度。如要設定僅經度的邊界，請分別使用 90 和 -90 的北緯和南緯。 |
center |
類型：
LatLngAltitude|LatLngAltitudeLiteral optional地圖中心以 LatLngAltitude 提供，其中海拔高度以公尺為單位，表示地面以上高度。請注意，這不一定是攝影機的位置，因為
range 欄位會影響攝影機與地圖中心的距離。如果未設定，則預設為 {lat: 0, lng: 0, altitude: 63170000}。63170000 公尺是允許的最大高度 (地球半徑乘以 10)。HTML 屬性：
|
defaultLabelsDisabled |
類型：
boolean optional預設值：
false當
true 時，系統不會算繪預設地圖標籤。HTML 屬性：
|
defaultUIDisabled |
類型：
boolean optional預設值：
false當
true 時，所有預設 UI 按鈕都會停用。不會停用鍵盤和手勢控制功能。HTML 屬性：
|
heading |
類型：
number optional地圖的指南針航向，以度為單位，正北為零。在沒有傾斜的情況下，系統會將任何傾斜動作解讀為方向。
HTML 屬性：
|
maxAltitude |
類型：
number optional地圖上顯示的最高海拔高度。有效值介於
0 和 63170000 公尺之間 (地球半徑乘以 10)。HTML 屬性：
|
maxHeading |
類型：
number optional地圖的最大方位角 (旋轉) 角度。有效值介於
0 和 360 度之間。minHeading 和 maxHeading 代表允許使用方向手勢的間隔，其範圍為 <= 360 度。minHeading = 180 和 maxHeading = 90 會允許 [0, 90] 和 [180, 360] 中的標題。minHeading = 90 和 maxHeading = 180 會允許在 [90, 180] 中使用標題。HTML 屬性：
|
maxTilt |
類型：
number optional地圖的最大入射角。有效值介於
0 和 90 度之間。HTML 屬性：
|
minAltitude |
類型：
number optional地圖上顯示的最低海拔高度。有效值介於
0 和 63170000 公尺之間 (地球半徑乘以 10)。HTML 屬性：
|
minHeading |
類型：
number optional地圖的標頭 (旋轉) 最小角度。有效值介於
0 和 360 度之間。minHeading 和 maxHeading 代表允許使用方向手勢的間隔，其範圍為 <= 360 度。minHeading = 180 和 maxHeading = 90 會允許 [0, 90] 和 [180, 360] 中的標題。minHeading = 90 和 maxHeading = 180 會允許在 [90, 180] 中使用標題。HTML 屬性：
|
minTilt |
類型：
number optional地圖的入射角最小值。有效值介於
0 和 90 度之間。HTML 屬性：
|
range |
類型：
number optional攝影機與地圖中心的距離，以公尺為單位。
HTML 屬性：
|
roll |
類型：
number optional相機環繞檢視向量旋轉的角度。為避免產生歧義，在沒有傾斜的情況下，系統會將任何傾斜解讀為方向。
HTML 屬性：
|
tilt |
類型：
number optional相機視角向量傾斜的角度，以度為單位。直接向下看地球的視圖向量會傾斜零度。指向地球外部的檢視向量會傾斜
180 度。HTML 屬性：
|
方法 | |
|---|---|
|
addEventListener(type, listener[, options])參數：
傳回值：
void設定函式，在指定事件傳送至目標時呼叫。請參閱 addEventListener |
flyCameraAround |
flyCameraAround(options)參數：
傳回值：無
這個方法會在指定時間內，讓攝影機圍繞特定位置旋轉，並在該時間內完成指定次數的旋轉。 根據預設，相機會順時針旋轉。如果提供的輪次為負數，攝影機會以逆時針方向運作。 由於動畫只能在地圖載入最少量資料後才會開始，因此該方法為非同步。動畫開始播放後，方法就會傳回。 如果輪數為零，系統就不會旋轉，且動畫會在開始後立即結束。 |
flyCameraTo |
flyCameraTo(options)參數：
傳回值：無
這個方法會在指定時間內，以拋物線方式將攝影機從目前位置移至指定終點位置。 由於動畫只能在地圖載入最少量資料後才會開始，因此該方法為非同步。動畫開始播放後，方法就會傳回。 |
|
removeEventListener(type, listener[, options])參數：
傳回值：
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener |
stopCameraAnimation |
stopCameraAnimation()參數：無
傳回值：無
這個方法會停止任何可能正在執行的飛越動畫。相機會停留在動畫中間的任何位置，不會傳送至終點。 由於動畫只能在地圖載入最少量資料後開始或停止，因此該方法為非同步。動畫停止後，方法就會傳回。 |
活動 | |
|---|---|
gmp-animationend |
function(animationEndEvent)引數：
飛行動畫結束時會觸發此事件。這個事件會透過 DOM 樹狀結構向上傳遞。 |
gmp-centerchange |
function(centerChangeEvent)引數：
當 Map3DElement 的 center 屬性變更時，系統會觸發此事件。 |
gmp-click |
function(clickEvent)引數：
點選 Map3DElement 元素時，系統會觸發此事件。 |
gmp-headingchange |
function(headingChangeEvent)引數：
當 Map3DElement 的標頭屬性變更時，系統會觸發此事件。 |
gmp-rangechange |
function(rangeChangeEvent)引數：
當 Map3DElement 的 range 屬性變更時，系統會觸發此事件。 |
gmp-rollchange |
function(rollChangeEvent)引數：
當 Map3DElement 的 roll 屬性變更時，系統會觸發此事件。 |
gmp-steadychange |
function(steadyChangeEvent)引數：
當 Map3DElement 的穩態發生變化時，系統會觸發此事件。 |
gmp-tiltchange |
function(tiltChangeEvent)引數：
當 Map3DElement 的傾斜屬性變更時，系統會觸發此事件。 |
Map3DElementOptions 介面
google.maps.maps3d.Map3DElementOptions
介面
Map3DElementOptions 物件用於定義可在 Map3DElement 上設定的屬性。
屬性 | |
|---|---|
bounds optional |
類型：
LatLngBounds|LatLngBoundsLiteral optional詳情請參閱《 Map3DElement.bounds》。 |
center optional |
類型：
LatLngAltitude|LatLngAltitudeLiteral optional詳情請參閱《 Map3DElement.center》。 |
defaultLabelsDisabled optional |
類型：
boolean optional |
defaultUIDisabled optional |
類型：
boolean optional詳情請參閱《 Map3DElement.defaultUIDisabled》。 |
heading optional |
類型：
number optional詳情請參閱《 Map3DElement.heading》。 |
maxAltitude optional |
類型：
number optional詳情請參閱《 Map3DElement.maxAltitude》。 |
maxHeading optional |
類型：
number optional詳情請參閱《 Map3DElement.maxHeading》。 |
maxTilt optional |
類型：
number optional詳情請參閱《 Map3DElement.maxTilt》。 |
minAltitude optional |
類型：
number optional詳情請參閱《 Map3DElement.minAltitude》。 |
minHeading optional |
類型：
number optional詳情請參閱《 Map3DElement.minHeading》。 |
minTilt optional |
類型：
number optional詳情請參閱《 Map3DElement.minTilt》。 |
range optional |
類型：
number optional詳情請參閱《 Map3DElement.range》。 |
roll optional |
類型：
number optional詳情請參閱《 Map3DElement.roll》。 |
tilt optional |
類型：
number optional詳情請參閱《 Map3DElement.tilt》。 |
FlyAroundAnimationOptions 介面
google.maps.maps3d.FlyAroundAnimationOptions
介面
FlyCameraAround 動畫的自訂選項。
屬性 | |
|---|---|
camera |
類型：
CameraOptions在旋轉動畫期間，相機應看向的中心點。請注意，當相機圍繞這個中心點旋轉時，地圖方向會隨之變更。 |
durationMillis optional |
類型：
number optional動畫的時間長度 (以毫秒為單位)。這是動畫的總時間長度，而非單一旋轉動作的時間長度。 |
rounds optional |
類型：
number optional在指定時間內，圍繞中心旋轉的圈數。這項屬性可控制旋轉的整體速度。將負數傳遞至 rounds 會導致攝影機以逆時針方向旋轉，而非預設的順時針方向。 |
FlyToAnimationOptions 介面
google.maps.maps3d.FlyToAnimationOptions
介面
FlyCameraTo 動畫的自訂選項。
屬性 | |
|---|---|
endCamera |
類型：
CameraOptions動畫結束時，相機應指向的位置。 |
durationMillis optional |
類型：
number optional動畫的時間長度 (以毫秒為單位)。時間長度為 0 時，攝影機會直接傳送至結束位置。 |
CameraOptions 介面
google.maps.maps3d.CameraOptions
介面
CameraOptions 物件用於定義可在相機物件上設定的屬性。相機物件可以是任何具有相機位置的物件，例如目前的地圖狀態，或未來要求的動畫狀態。
屬性 | |
|---|---|
center optional |
類型：
LatLngAltitude|LatLngAltitudeLiteral optional詳情請參閱《 Map3DElement.center》。 |
heading optional |
類型：
number optional詳情請參閱《 Map3DElement.heading》。 |
range optional |
類型：
number optional詳情請參閱《 Map3DElement.range》。 |
roll optional |
類型：
number optional詳情請參閱《 Map3DElement.roll》。 |
tilt optional |
類型：
number optional詳情請參閱《 Map3DElement.tilt》。 |
SteadyChangeEvent 類別
google.maps.maps3d.SteadyChangeEvent
class
這項事件是透過監控 Map3DElement 的穩定狀態建立。這個事件會透過 DOM 樹狀結構向上傳遞。
這個類別會擴充 Event。
請呼叫 const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d") 存取。請參閱「Maps JavaScript API 中的程式庫」。
屬性 | |
|---|---|
isSteady |
類型：
boolean指出 Map3DElement 是否穩定 (即目前場景的所有算繪作業都已完成)。 |
LocationClickEvent 類別
google.maps.maps3d.LocationClickEvent
class
這項事件是透過點選 Map3DElement 建立。
這個類別會擴充 Event。
請呼叫 const {LocationClickEvent} = await google.maps.importLibrary("maps3d") 存取。請參閱「Maps JavaScript API 中的程式庫」。
屬性 | |
|---|---|
position |
類型：
LatLngAltitude optional事件發生時，游標下方的緯度/經度/高度。請注意，在較粗略的層級，系統會傳回精確度較低的資料。此外，如果從較高的位置點選水面，系統可能會傳回海底高度值做為海拔高度值。這個事件會透過 DOM 樹狀結構向上傳遞。 |
PlaceClickEvent 類別
google.maps.maps3d.PlaceClickEvent
class
這項事件是透過點選 Map3DElement 建立。
這個類別會擴充 LocationClickEvent。
請呼叫 const {PlaceClickEvent} = await google.maps.importLibrary("maps3d") 存取。請參閱「Maps JavaScript API 中的程式庫」。
屬性 | |
|---|---|
placeId |
類型：
string地圖地圖項目的 ID。 |
繼承：
position
| |
方法 | |
|---|---|
fetchPlace |
fetchPlace()參數：無
擷取此地點 ID 的 Place。在產生的 Place 物件中，系統會填入 id 屬性。之後您可以透過 Place.fetchFields() 要求其他欄位，但必須遵守正常的 Places API 啟用和計費規定。如果擷取 Place 時發生錯誤，則會拒絕承諾。 |
Marker3DElement 類別
google.maps.maps3d.Marker3DElement
class
在 3D 地圖上顯示位置。請注意，必須設定 position，Marker3DElement 才能顯示。
自訂元素：
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" 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標記尖端的位置。在某些模式中，系統會忽略高度，因此高度為選用值。 |
sizePreserved |
類型：
boolean optional預設值：
false指定無論與攝影機的距離為何，此標記是否應保留其大小。根據預設，標記會根據距離攝影機/傾斜角度進行縮放。
HTML 屬性：
|
zIndex |
類型：
number optional與其他標記相比的 zIndex。
HTML 屬性：
|
運算單元 | |
|---|---|
default |
任何直接新增至 Marker3DElement 的自訂元素都會被插入，但只有 HTMLImageElement、SVGElement 和 PinElement 類型的元素會用於繪製標記，其他元素會遭到忽略。HTMLImageElement 和 SVGElement 必須先包裝在 <template> 元素中，才能指派至 Marker3DElement 的預設插槽。目前，圖片和 SVG 會先經過光柵化，才會在 3D 場景中算繪，因此不會套用嵌入 SVG 或新增至圖片的 CSS 類別自訂 HTML，且在螢幕上顯示標記時，可能不會顯示。 |
方法 | |
|---|---|
|
addEventListener(type, listener[, options])參數：
傳回值：
void設定函式，在指定事件傳送至目標時呼叫。請參閱 addEventListener |
|
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-marker-3d-interactive>
這個類別會擴充 Marker3DElement。
這個類別會實作 Marker3DInteractiveElementOptions。
請呼叫 const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d") 存取。請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Marker3DInteractiveElement |
Marker3DInteractiveElement([options])參數：
使用指定的選項建立 Marker3DInteractiveElement。 |
屬性 | |
|---|---|
繼承：
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。
屬性 | |
|---|---|
繼承：
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" src="src"></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 地圖上定位模型。 系統會依以下順序將旋轉套用至模型：傾斜、傾斜和標頭。 |
position |
類型：
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional設定 Model3DElement 的位置。在某些模式中，系統會忽略高度，因此高度為選用值。 |
scale |
類型：
number|Vector3D|Vector3DLiteral optional預設值：
1沿著模型座標空間中的 x、y 和 z 軸縮放模型。 |
src |
類型：
string|URL optional指定 3D 模型的網址。目前僅支援
.glb 格式的模型。任何相對 HTTP 網址都會解析為對應的絕對網址。 請注意，如果您將 .glb 模型檔案代管在與主要應用程式不同的網站或伺服器上，請務必設定正確的 CORS HTTP 標頭。這樣一來，應用程式就能安全地存取其他網域的模型檔案。HTML 屬性：
|
方法 | |
|---|---|
|
addEventListener(type, listener[, options])參數：
傳回值：
void設定函式，在指定事件傳送至目標時呼叫。請參閱 addEventListener |
|
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》。 |
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" 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 屬性：
|
coordinates |
類型：
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional折線座標的排列順序。在某些模式中，系統會忽略高度，因此高度為選用值。 |
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 屬性：
|
strokeColor |
類型：
string optional筆觸色彩。系統支援所有 CSS3 顏色。
HTML 屬性：
|
strokeWidth |
類型：
number optional筆觸寬度 (以像素為單位)。
HTML 屬性：
|
zIndex |
類型：
number optional和其他多邊形比較的 zIndex。
HTML 屬性：
|
方法 | |
|---|---|
|
addEventListener(type, listener[, options])參數：
傳回值：
void設定函式，在指定事件傳送至目標時呼叫。請參閱 addEventListener |
|
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詳情請參閱《 Polyline3DElement.coordinates》。 |
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》。 |
Polygon3DElement 類別
google.maps.maps3d.Polygon3DElement
class
3D 多邊形 (例如 3D 折線) 會以有序序列定義一系列連接的座標。此外，多邊形會形成封閉迴圈，並定義填滿的區域。
自訂元素：
<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>
這個類別會擴充 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 屬性：
|
innerCoordinates |
類型：
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional指定閉合迴圈的座標順序。與多邊形不同，多邊形可能包含一或多個路徑，這些路徑會在多邊形內建立多個切口。 |
outerCoordinates |
類型：
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional指定閉合迴圈的座標順序。在某些模式中，系統會忽略高度，因此高度為選用值。 |
strokeColor |
類型：
string optional筆觸色彩。系統支援所有 CSS3 顏色。
HTML 屬性：
|
strokeWidth |
類型：
number optional筆觸寬度 (以像素為單位)。
HTML 屬性：
|
zIndex |
類型：
number optional和其他多邊形比較的 zIndex。
HTML 屬性：
|
方法 | |
|---|---|
|
addEventListener(type, listener[, options])參數：
傳回值：
void設定函式，在指定事件傳送至目標時呼叫。請參閱 addEventListener |
|
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》。 |
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 |
可讓您根據地面、建築物和水面最高點來表示物件。在水上飛行時，這會是水面；在陸地上飛行時，這會是建築物表面 (如有) 或地面 (如沒有建築物)。 |