AdvancedMarkerElement 類別
google.maps.marker.AdvancedMarkerElement
類別
顯示地圖上的位置。請注意,您必須設定 position
,系統才會顯示 AdvancedMarkerElement
。
注意:做為網頁元件使用 (例如使用自訂 <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 |
addEventListener(type, listener[, options]) 參數:
傳回值:
void 設定會在指定事件傳送至目標時呼叫的函式。詳情請參閱 addEventListener |
addListener |
addListener(eventName, handler) 參數:
傳回值:
MapsEventListener 結果事件監聽器。將指定的事件監聽器函式新增至地圖事件系統中的特定事件名稱。 |
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
的選項。
屬性 | |
---|---|
collisionBehavior optional |
類型:
CollisionBehavior optional 此列舉可指定 AdvancedMarkerElement 與其他 AdvancedMarkerElement 或向量地圖上的基本地圖標籤衝突時應採取的行為。注意: |
content optional |
類型:
Node optional 支援 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 來提供 AdvancedMarkerElement 的位置。注意:只有向量地圖支援包含海拔高度的 |
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 元件使用 (例如做為 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 |
addEventListener(type, listener[, options]) 參數:
傳回值:
void 此函式目前尚未開放使用。 |
removeEventListener |
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 針腳的比例。 |