Draw on the map

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 屬性:
  • <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
類型:  CollisionBehavior optional
列舉,指定 Marker3DElement 與其他 Marker3DElement 或底圖標籤衝突時應呈現的行為。
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
類型:  boolean optional
預設值: false
指定是否要在標記遭到遮擋時繪製標記。標記可能會被地圖幾何圖形 (例如建築物) 遮擋。
HTML 屬性:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
類型:  boolean optional
預設值: false
指定是否要將標記連接至地面。如要凸出標記,altitudeMode 必須是 RELATIVE_TO_GROUND 或 ABSOLUTE。
HTML 屬性:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
類型:  string optional
這個標記要顯示的文字。
HTML 屬性:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
標記尖端的位置。在某些模式中,系統會忽略高度,因此可不提供。
HTML 屬性:
  • <gmp-marker-3d position="lat,lng"></gmp-marker-3d>
  • <gmp-marker-3d position="lat,lng,altitude"></gmp-marker-3d>
sizePreserved
類型:  boolean optional
預設值: false
指定這個標記是否應保持大小,無論與相機的距離為何。根據預設,標記會根據與攝影機/傾斜角度的距離縮放。
HTML 屬性:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
類型:  number optional
與其他標記相比的 zIndex。
HTML 屬性:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
直接新增至 Marker3DElement 的任何自訂元素都會加入版位,但只有 HTMLImageElement、SVGElement 和 PinElement 類型的元素會用於繪製標記,其他元素則會遭到忽略。
HTMLImageElement 和 SVGElement 必須先包裝在 <template> 元素中,才能指派給 Marker3DElement 的預設版位。

圖片和 SVG 目前會先經過光柵化,然後才在 3D 場景中算繪,因此嵌入 SVG 的自訂 HTML 或新增至圖片的 CSS 類別不會套用,且在畫面上顯示標記時可能不會反映。
addEventListener
addEventListener(type, listener[, options])
參數: 
  • type:string區分大小寫的字串,代表要監聽的事件類型。
  • listener:EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件
  • options:boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。
傳回值:  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
詳情請參閱《Marker3DElement.collisionBehavior》。
drawsWhenOccluded optional
類型:  boolean optional
詳情請參閱《Marker3DElement.drawsWhenOccluded》。
extruded optional
類型:  boolean optional
詳情請參閱《Marker3DElement.extruded》。
label optional
類型:  string optional
詳情請參閱《Marker3DElement.label》。
position 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 屬性:
  • <gmp-marker-3d-interactive gmp-popover-target="popover-id"></gmp-marker-3d-interactive>
title
類型:  string
滑鼠游標懸停效果文字。如果提供無障礙文字 (例如用於螢幕閱讀器),系統會將該文字新增至 Marker3DInteractiveElement,並使用提供的值。
HTML 屬性:
  • <gmp-marker-3d-interactive title="string"></gmp-marker-3d-interactive>
繼承: altitudeMode、collisionBehavior、drawsWhenOccluded、extruded、label、position、sizePreserved、zIndex
default
直接新增至 Marker3DInteractiveElement 的任何自訂元素都會插入,但只有 PinElement 類型的元素會用於繪製標記,其他元素則會忽略。
addEventListener
addEventListener(type, listener[, options])
參數: 
  • type:string區分大小寫的字串,代表要監聽的事件類型。
  • listener:EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件
  • options:boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。
傳回值:  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 屬性:
  • <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
類型:  Orientation3D|Orientation3DLiteral optional
說明 3D 模型座標系統的旋轉角度,以便將模型放置在 3D 地圖上。

系統會按照下列順序對模型套用旋轉:滾動、傾斜,然後是航向。
HTML 屬性:
  • <gmp-model-3d orientation="heading,tilt,roll"></gmp-model-3d>
position
設定 Model3DElement 的位置。在某些模式中,系統會忽略高度,因此可不提供。
HTML 屬性:
  • <gmp-model-3d position="lat,lng"></gmp-model-3d>
  • <gmp-model-3d position="lat,lng,altitude"></gmp-model-3d>
scale
類型:  number|Vector3D|Vector3DLiteral optional
預設值: 1
在模型的座標空間中,沿著 x、y 和 z 軸縮放模型。
HTML 屬性:
  • <gmp-model-3d scale="number"></gmp-model-3d>
  • <gmp-model-3d scale="x,y,z"></gmp-model-3d>
src
類型:  string|URL optional
指定 3D 模型的網址。目前僅支援 .glb 格式的模型。

所有相對 HTTP 網址都會解析為對應的絕對網址。

請注意,如果 .glb 模型檔案託管在與主要應用程式不同的網站或伺服器上,請務必設定正確的 CORS HTTP 標頭。這樣一來,應用程式就能安全地存取其他網域的模型檔案。
HTML 屬性:
  • <gmp-model-3d src="url"></gmp-model-3d>
addEventListener
addEventListener(type, listener[, options])
參數: 
  • type:string區分大小寫的字串,代表要監聽的事件類型。
  • listener:EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件
  • options:boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。
傳回值:  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
詳情請參閱《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])
參數: 
  • type:string區分大小寫的字串,代表要監聽的事件類型。
  • listener:EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件
  • options:boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。
傳回值:  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 屬性:
  • <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>
drawsOccludedSegments
類型:  boolean optional
預設值: false
指定是否要繪製可能遭到遮蔽的折線部分。折線可能會被地圖幾何圖形 (例如建築物) 遮擋。
HTML 屬性:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
類型:  boolean optional
預設值: false
指定是否要將折線連接至地面。如要擠出折線,altitudeMode 必須是 RELATIVE_TO_GROUND 或 ABSOLUTE。
HTML 屬性:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
類型:  boolean optional
預設值: false
如果設為 true,折線邊緣會解讀為測地線,並沿著地球曲率繪製。如果設為 false,折線邊緣會在螢幕空間中算繪為直線。
HTML 屬性:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
類型:  string optional
外圈顏色。系統支援所有 CSS3 顏色。
HTML 屬性:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
類型:  number optional
外寬介於 0.0 和 1.0 之間。這是strokeWidth的百分比。
HTML 屬性:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
path
折線座標的排列順序。在某些模式中,系統會忽略高度,因此可不提供。
HTML 屬性:
  • <gmp-polyline-3d path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."></gmp-polyline-3d>
strokeColor
類型:  string optional
筆觸色彩。系統支援所有 CSS3 顏色。
HTML 屬性:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
類型:  number optional
筆觸寬度 (以像素為單位)。
HTML 屬性:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
類型:  number optional
和其他多邊形比較的 zIndex。
HTML 屬性:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
coordinates
折線座標的排列順序。在某些模式中,系統會忽略高度,因此可不提供。
addEventListener
addEventListener(type, listener[, options])
參數: 
  • type:string區分大小寫的字串,代表要監聽的事件類型。
  • listener:EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件
  • options:boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。
傳回值:  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
詳情請參閱《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》。

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、coordinates
addEventListener
addEventListener(type, listener[, options])
參數: 
  • type:string區分大小寫的字串,代表要監聽的事件類型。
  • listener:EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件
  • options:boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。
傳回值:  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 屬性:
  • <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
類型:  boolean optional
預設值: false
指定是否繪製多邊形可能被遮擋的部分。多邊形可能會被地圖幾何圖形 (例如建築物) 遮擋。
HTML 屬性:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
類型:  boolean optional
預設值: false
指定是否要將多邊形連接至地面。如要擠出多邊形,altitudeMode 必須是 RELATIVE_TO_GROUND 或 ABSOLUTE。
HTML 屬性:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
類型:  string optional
填色。系統支援所有 CSS3 顏色。
HTML 屬性:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
類型:  boolean optional
預設值: false
如果設為 true,多邊形的邊緣會解讀為測地線,並沿著地球曲率繪製。如果設為 false,多邊形的邊緣會在螢幕空間中轉譯為直線。
HTML 屬性:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerPaths
指定閉合迴圈的座標順序。與折線不同,多邊形可能由一或多個路徑組成,在多邊形內建立多個切口。
path
指定閉合迴圈的座標順序。在某些模式中,系統會忽略高度,因此可不提供。
HTML 屬性:
  • <gmp-polygon-3d path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."></gmp-polygon-3d>
strokeColor
類型:  string optional
筆觸色彩。系統支援所有 CSS3 顏色。
HTML 屬性:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
類型:  number optional
筆觸寬度 (以像素為單位)。
HTML 屬性:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
類型:  number optional
和其他多邊形比較的 zIndex。
HTML 屬性:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
outerCoordinates
指定閉合迴圈的座標順序。在某些模式中,系統會忽略高度,因此可不提供。
innerCoordinates
指定閉合迴圈的座標順序。與折線不同,多邊形可能由一或多個路徑組成,在多邊形內建立多個切口。
addEventListener
addEventListener(type, listener[, options])
參數: 
  • type:string區分大小寫的字串,代表要監聽的事件類型。
  • listener:EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件
  • options:boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。
傳回值:  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
詳情請參閱《Polygon3DElement.innerCoordinates》。
outerCoordinates optional
詳情請參閱《Polygon3DElement.outerCoordinates》。
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、outerCoordinates、innerCoordinates
addEventListener
addEventListener(type, listener[, options])
參數: 
  • type:string區分大小寫的字串,代表要監聽的事件類型。
  • listener:EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件
  • options:boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。
傳回值:  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 屬性:
  • <gmp-popover altitude-mode="absolute"></gmp-popover>
  • <gmp-popover altitude-mode="clamp-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-mesh"></gmp-popover>
autoPanDisabled
類型:  boolean optional
預設值: false
如果設為 True,系統會在彈出式視窗開啟時,停用平移地圖功能,讓彈出式視窗完整顯示。
HTML 屬性:
  • <gmp-popover auto-pan-disabled></gmp-popover>
lightDismissDisabled
類型:  boolean optional
預設值: false
指定是否要「輕觸關閉」這個彈出式視窗。「輕觸關閉」行為與設定 popover="auto" 屬性類似,該屬性是瀏覽器 Popover API 的一部分。
HTML 屬性:
  • <gmp-popover light-dismiss-disabled></gmp-popover>
open
類型:  boolean optional
預設值: false
指定是否應開啟這個彈出式視窗。
HTML 屬性:
  • <gmp-popover open></gmp-popover>
positionAnchor
顯示這個彈出式視窗的位置。如果彈出式視窗錨定至互動式標記,系統會改用標記的位置。
HTML 屬性:
  • <gmp-popover position-anchor="lat,lng"></gmp-popover>
  • <gmp-popover position-anchor="lat,lng,altitude"></gmp-popover>
  • <gmp-popover position-anchor="marker-id"></gmp-popover>
default
將插槽內容放在彈出式視窗的主要部分。
header
將插槽內容放在彈出式視窗的標題部分。
--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])
參數: 
  • type:string區分大小寫的字串,代表要監聽的事件類型。
  • listener:EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件
  • options:boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。
傳回值:  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
詳情請參閱《PopoverElement.lightDismissDisabled》。
open optional
類型:  boolean optional
詳情請參閱《PopoverElement.open》。
positionAnchor 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 可相對於地面、建築物和水面的最高點,表示物件。如果是在水面上,則為水面;如果是在地形上,則為建築物表面 (如有) 或地面 (如無建築物)。