AdvancedMarkerElement 類別
google.maps.marker.AdvancedMarkerElement
class
在地圖上顯示位置。請注意，必須設定 position，系統才會顯示 AdvancedMarkerElement。
自訂元素：
<gmp-advanced-marker anchor-left="string" anchor-top="string" gmp-clickable 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 新增至地圖。 |
屬性 | |
|---|---|
anchorLeft |
類型：
string optional預設值：「-50%」
CSS 長度百分比值，用於從標記左上角偏移標記的錨點。如果使用的圖像錨點與預設標記的一般底部中心點不同，這個方法就非常實用。
HTML 屬性：
|
anchorTop |
類型：
string optional預設值：「-100%」
CSS 長度百分比值，用於從標記左上角偏移標記的錨點。如果使用的圖像錨點與預設標記的一般底部中心點不同，這個方法就非常實用。
HTML 屬性：
|
collisionBehavior |
類型：
CollisionBehavior optional |
gmpClickable |
類型：
boolean optionalHTML 屬性：
|
gmpDraggable |
類型：
boolean optional |
map |
類型：
Map optional詳情請參閱《 AdvancedMarkerElementOptions.map》。 |
position |
類型：
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalHTML 屬性：
|
title |
類型：
stringHTML 屬性：
|
zIndex |
類型：
number optional |
|
類型：
HTMLElement這個欄位為唯讀。支援檢視畫面的 DOM 元素。 |
|
類型：
Node optional |
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數：
傳回值：
void設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener |
addListener |
addListener(eventName, handler)參數：
傳回值：
MapsEventListener 產生的事件監聽器。將指定的事件監聽器函式，新增至 Maps 事件系統中的指定事件名稱。 |
removeEventListener |
removeEventListener(type, listener[, options])參數：
傳回值：
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
事件 | |
|---|---|
click |
function(event)引數：
|
drag |
function(event)引數：
|
dragend |
function(event)引數：
|
dragstart |
function(event)引數：
|
gmp-click |
function(event)引數：
|
AdvancedMarkerElementOptions 介面
google.maps.marker.AdvancedMarkerElementOptions
介面
建構 AdvancedMarkerElement 的選項。
屬性 | |
|---|---|
anchorLeft optional |
類型：
string optional預設值：「-50%」
CSS 長度百分比值，用於從標記左上角偏移標記的錨點。如果使用的圖像錨點與預設標記的一般底部中心點不同，這個方法就非常實用。 |
anchorTop optional |
類型：
string optional預設值：「-100%」
CSS 長度百分比值，用於從標記左上角偏移標記的錨點。如果使用的圖像錨點與預設標記的一般底部中心點不同，這個方法就非常實用。 |
collisionBehavior optional |
類型：
CollisionBehavior optional這個列舉會指定 AdvancedMarkerElement 與其他 AdvancedMarkerElement 或向量地圖上的基本地圖標籤衝突時，應呈現的行為。注意： |
content optional |
類型：
Node optional預設值：
PinElement支援 AdvancedMarkerElement 視覺效果的 DOM 元素。注意： |
gmpClickable optional |
類型：
boolean optional預設值：
false如果 true，AdvancedMarkerElement 將可點擊並觸發 gmp-click 事件，且可互動以提供無障礙功能 (例如允許透過方向鍵進行鍵盤導覽)。 |
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
class
點選進階標記時，系統會建立這個事件。使用 event.target.position 存取標記的位置。
這個類別會擴充 Event。
呼叫 const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
PinElement 類別
google.maps.marker.PinElement
class
PinElement 代表由形狀和字符組成的 DOM 元素。形狀的對話框樣式與預設 AdvancedMarkerElement 或 Marker3DElement 相同。字元是選用的 DOM 元素，會顯示在氣球形狀中。PinElement 的顯示比例可能會因PinElement.scale而異。
這個類別會擴充 HTMLElement。
這個類別會實作 PinElementOptions。
呼叫 const {PinElement} = await google.maps.importLibrary("marker") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
PinElement |
PinElement([options])參數：
|
屬性 | |
|---|---|
background |
類型：
string optional詳情請參閱《 PinElementOptions.background》。 |
borderColor |
類型：
string optional詳情請參閱《 PinElementOptions.borderColor》。 |
glyphColor |
類型：
string optional詳情請參閱《 PinElementOptions.glyphColor》。 |
glyphSrc |
類型：
URL|string optional詳情請參閱《 PinElementOptions.glyphSrc》。 |
glyphText |
類型：
string optional詳情請參閱《 PinElementOptions.glyphText》。 |
scale |
類型：
number optional詳情請參閱《 PinElementOptions.scale》。 |
|
類型：
HTMLElement這個欄位為唯讀。支援檢視畫面的 DOM 元素。 |
|
詳情請參閱《 |
方法 | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])參數：
傳回值：
void設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。 |
removeEventListener |
removeEventListener(type, listener[, options])參數：
傳回值：
void從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。 |
PinElementOptions 介面
google.maps.marker.PinElementOptions
介面
建立PinElement的選項。
屬性 | |
|---|---|
background optional |
類型：
string optional圖釘形狀的背景顏色。支援任何 CSS 顏色值。 |
borderColor optional |
類型：
string optional圖釘形狀的邊框顏色。支援任何 CSS 顏色值。 |
|
圖釘中顯示的 DOM 元素。 |
glyphColor optional |
類型：
string optional字符的顏色。支援任何 CSS 顏色值。 |
glyphSrc optional |
類型：
URL|string optional圖釘中顯示的字符圖片來源。 |
glyphText optional |
類型：
string optional圖釘中顯示的文字。 |
scale optional |
類型：
number optional預設值：
1圖釘的比例。 |