AdvancedMarkerElement 類別
google.maps.marker.AdvancedMarkerElement
類別
在地圖上顯示位置。請注意,您必須為 AdvancedMarkerElement
設定 position
,以供顯示。
注意:以網站元件的形式使用 (例如使用自訂 <gmp-advanced-marker>
HTML 元素),僅適用於 v=beta
頻道。
自訂元素:
<gmp-advanced-marker position="lat,lng" title="string"></gmp-advanced-marker>
這個類別會擴充 HTMLElement
。
這個類別會實作 AdvancedMarkerElementOptions
。
呼叫 const {AdvancedMarkerElement} = await google.maps.importLibrary("marker")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
AdvancedMarkerElement |
AdvancedMarkerElement([options]) 參數:
使用指定選項建立 AdvancedMarkerElement 。如果指定了地圖,系統會在建構時將 AdvancedMarkerElement 新增至地圖。 |
屬性 | |
---|---|
collisionBehavior |
類型:
CollisionBehavior optional |
content |
類型:
Node optional |
element |
類型:
HTMLElement 這是唯讀欄位。支援檢視畫面的 DOM 元素。 |
gmpDraggable |
類型:
boolean optional |
map |
類型:
Map optional |
position |
類型:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional HTML 屬性:
|
title |
類型:
string HTML 屬性:
|
zIndex |
類型:
number optional |
方法 | |
---|---|
|
addEventListener(type, listener[, options]) 參數:
傳回價值:
void 設定一個函式,以便在指定事件傳送至目標時呼叫。請參閱 addEventListener |
addListener |
addListener(eventName, handler) 參數:
傳回值:
MapsEventListener 產生的事件監聽器。將指定的事件監聽器函式新增至地圖事件系統中的指定事件名稱。 |
|
removeEventListener(type, listener[, options]) 參數:
傳回價值:
void 從目標中移除先前透過 addEventListener 註冊的事件監聽器。請參閱 removeEventListener |
事件 | |
---|---|
click |
function(event) 引數:
|
drag |
function(event) 引數:
|
dragend |
function(event) 引數:
|
dragstart |
function(event) 引數:
|
|
function(event) 引數:
|
AdvancedMarkerElementOptions 介面
google.maps.marker.AdvancedMarkerElementOptions
介面
建構 AdvancedMarkerElement
的選項。
屬性 | |
---|---|
collisionBehavior optional |
類型:
CollisionBehavior optional 這個列舉項目指定 AdvancedMarkerElement 與其他 AdvancedMarkerElement 或向量地圖中的基本地圖標籤衝突時,應採取的行為。注意: |
content optional |
類型:
Node optional 預設值:
PinElement.element 支援 AdvancedMarkerElement 視覺功能的 DOM 元素。注意: |
gmpDraggable optional |
類型:
boolean optional 預設值:
false 如果為 true ,則可拖曳 AdvancedMarkerElement 。注意:無法拖曳具有高度的 |
map optional |
類型:
Map optional 要顯示 AdvancedMarkerElement 的地圖。地圖必須顯示 AdvancedMarkerElement ,如果建構失敗,則透過設定 AdvancedMarkerElement.map 來提供。 |
position optional |
類型:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 設定 AdvancedMarkerElement 的位置。AdvancedMarkerElement 可能會在沒有位置的情況下建構,但會在提供位置之前顯示,例如使用者的動作或選項。如未提供 AdvancedMarkerElement ,則提供 AdvancedMarkerElement.position 時提供。注意:向量地圖僅支援高度的 |
title optional |
類型:
string optional 滑鼠遊標懸停文字。如有提供,無障礙文字 (例如用於螢幕閱讀器) 會新增至含有指定值的 AdvancedMarkerElement 。 |
zIndex optional |
類型:
number optional 所有 AdvancedMarkerElement 都會按照 zIndex 順序顯示在地圖上,值較高的 AdvancedMarkerElement 會比值較低的值優先顯示。根據預設,AdvancedMarkerElement 會根據螢幕上的垂直位置顯示,而 AdvancedMarkerElement 顯示的位置較距離螢幕較遠 AdvancedMarkerElement 。請注意,zIndex 也有助於判斷 CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY 進階標記之間的相對優先順序。zIndex 值越高,表示優先順序越高。 |
AdvancedMarkerClickEvent 類別
google.maps.marker.AdvancedMarkerClickEvent
類別
這項事件是透過點選進階標記建立。使用 event.target.position
存取標記的位置。
這個類別會擴充 Event
。
呼叫 const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
PinElement 類別
google.maps.marker.PinElement
類別
PinElement
代表由形狀和字符組成的 DOM 元素。形狀的樣式與預設 AdvancedMarkerElement
相同。字符是氣球形狀中顯示的選用 DOM 元素。PinElement
可能會有不同的長寬比,視 PinElement.scale
而定。
注意:目前不支援在 Web Components 中使用 (例如做為 HTMLElement 子類別的使用,或透過 HTML 使用)。
這個類別會擴充 HTMLElement
。
這個類別會實作 PinElementOptions
。
呼叫 const {PinElement} = await google.maps.importLibrary("marker")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
PinElement |
PinElement([options]) 參數:
|
屬性 | |
---|---|
background |
類型:
string optional |
borderColor |
類型:
string optional |
element |
類型:
HTMLElement 這是唯讀欄位。支援檢視畫面的 DOM 元素。 |
glyph |
|
glyphColor |
類型:
string optional |
scale |
類型:
number optional |
方法 | |
---|---|
|
addEventListener(type, listener[, options]) 參數:
傳回價值:
void 此功能尚未開放使用。 |
|
removeEventListener(type, listener[, options]) 參數:
傳回價值:
void 從目標中移除先前透過 addEventListener 註冊的事件監聽器。請參閱 removeEventListener |
PinElementOptions 介面
google.maps.marker.PinElementOptions
介面
建立 PinElement
的選項。
屬性 | |
---|---|
background optional |
類型:
string optional 圖釘形狀的背景顏色。支援任何 CSS 顏色值。 |
borderColor optional |
類型:
string optional 圖釘形狀的邊框顏色。支援任何 CSS 顏色值。 |
glyph optional |
圖釘中顯示的 DOM 元素。 |
glyphColor optional |
類型:
string optional 字符的顏色。支援任何 CSS 顏色值。 |
scale optional |
類型:
number optional 預設值:
1 圖釘尺寸。 |