Advanced Markers (beta)

AdvancedMarkerView類別

google.maps.marker.AdvancedMarkerView 類別

使用指定選項建立 AdvancedMarkerView。如果有指定地圖，則系統會在建構時將 AdvancedMarkerView 加到地圖中。請注意，你必須設定該位置，AdvancedMarkerView 才會顯示。

這個類別會實作 AdvancedMarkerViewOptions。

必須使用 &libraries=marker 網址參數。請參閱 Maps JavaScript API 中的程式庫。
AdvancedMarkerView
AdvancedMarkerView([options])
參數：
collisionBehavior
類型：CollisionBehavior optional
詳情請參閱《AdvancedMarkerViewOptions.collisionBehavior》。
content
類型：Element optional
詳情請參閱《AdvancedMarkerViewOptions.content》。
draggable
類型：boolean optional
詳情請參閱《AdvancedMarkerViewOptions.draggable》。
element optional
類型：Element optional
這是唯讀欄位。支援檢視畫面的 DOM 元素。
map
類型：Map optional
詳情請參閱《AdvancedMarkerViewOptions.map》。
position
詳情請參閱《AdvancedMarkerViewOptions.position》。
title
類型：string optional
詳情請參閱《AdvancedMarkerViewOptions.title》。
zIndex
類型：number optional
詳情請參閱《AdvancedMarkerViewOptions.zIndex》。
addListener
addListener(eventName, handler)
參數：
傳回值：MapsEventListener
將指定的事件監聽器函式新增至指定的事件名稱。
click
function(event)
引數：
按下 AdvancedMarkerView 元素時，會觸發此事件。
drag
function(event)
引數：
這個事件會在使用者拖曳 AdvancedMarkerView 時重複觸發。
dragend
function(event)
引數：
使用者停止拖曳 AdvancedMarkerView 時，就會觸發此事件。
dragstart
function(event)
引數：
使用者開始拖曳 AdvancedMarkerView 時，就會觸發此事件。

AdvancedMarkerViewOptions 介面

google.maps.marker.AdvancedMarkerViewOptions 介面

建構 AdvancedMarkerView 的選項。

必須使用 &libraries=marker 網址參數。請參閱 Maps JavaScript API 中的程式庫。
collisionBehavior optional
類型：CollisionBehavior optional
指定 AdvancedMarkerView 與另一個 AdvancedMarkerView 或向量地圖上的基本地圖標籤互動時，應執行的動作。

注意：AdvancedMarkerView 到 AdvancedMarkerView 的衝突可在光柵圖和向量地圖上使用，但 AdvancedMarkerView 的基本地圖標籤衝突則僅適用於向量地圖。
content optional
類型：Element optional
支援 AdvancedMarkerView 視覺圖像的 DOM 元素。

注意：AdvancedMarkerView 不會複製傳入的 DOM 元素。當 DOM 元素傳送至 AdvancedMarkerView 時，將相同的 DOM 元素傳遞至另一個 AdvancedMarkerView 會移動 DOM 元素，讓先前的 AdvancedMarkerView 看起來為空白。
draggable optional
類型：boolean optional
預設：false
如果為 true，則可拖曳 AdvancedMarkerView。

注意：無法調整高度的 AdvancedMarkerView。
element optional
類型：Element optional
這是唯讀欄位。支援檢視畫面的 DOM 元素。
map optional
類型：Map optional
顯示 AdvancedMarkerView 的地圖。該地圖需要顯示 AdvancedMarkerView，如果建構時未提供，則可透過設定 AdvancedMarkerView.map 提供。
position optional
設定 AdvancedMarkerView 的位置。即使沒有位置也能夠建構 AdvancedMarkerView，但在提供該位置之前 (例如使用者的動作或選項)，才會顯示。如果建構時未提供 AdvancedMarkerView，可透過設定 AdvancedMarkerView.position 提供 AdvancedMarkerView 的位置。

注意：只有海拔高度地圖支援包含高度的 AdvancedMarkerView。
title optional
類型：string optional
滑鼠遊標懸停的文字。如有提供，系統會為指定值新增無障礙文字 (例如用於螢幕閱讀器) 的 AdvancedMarkerView。
zIndex optional
類型：number optional
所有 AdvancedMarkerView 都會依照 ZIndex 的順序在地圖上顯示，值越大的 AdvancedMarkerView 值越大，值越低。根據預設，AdvancedMarkerView 會根據螢幕上的垂直位置顯示，較低的 AdvancedMarkerView 會顯示在畫面較遠的 AdvancedMarkerView 前面。請注意，zIndex 也可用來協助判斷 CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY 進階標記之間的相對優先順序。zIndex 值越高，表示優先順序越高。

PinView 類別

google.maps.marker.PinView 類別

PinView 代表由形狀和字符組成的 DOM 元素。形狀與預設 AdvancedMarkerView 中的說明框樣式相同。字符是呈現資訊框形狀的選擇性 DOM 元素。PinView 的長寬比可能不同，取決於其 PinView.scale。

這個類別會實作 PinViewOptions。

必須使用 &libraries=marker 網址參數。請參閱 Maps JavaScript API 中的程式庫。
PinView
PinView([options])
參數：
background
類型：string optional
詳情請參閱《PinViewOptions.background》。
borderColor
類型：string optional
詳情請參閱《PinViewOptions.borderColor》。
element optional
類型：Element optional
這是唯讀欄位。支援檢視畫面的 DOM 元素。
glyph
類型：string|Element|URL optional
詳情請參閱《PinViewOptions.glyph》。
glyphColor
類型：string optional
詳情請參閱《PinViewOptions.glyphColor》。
scale
類型：number optional
詳情請參閱《PinViewOptions.scale》。
addListener
addListener(eventName, handler)
參數：
傳回值：MapsEventListener
將指定的事件監聽器函式新增至指定的事件名稱。

PinViewOptions 介面

google.maps.marker.PinViewOptions 介面

建立 PinView 的選項。

必須使用 &libraries=marker 網址參數。請參閱 Maps JavaScript API 中的程式庫。
background optional
類型：string optional
圖釘形狀的背景顏色。支援任何 CSS 色彩值。
borderColor optional
類型：string optional
圖釘形狀的邊框顏色。支援任何 CSS 色彩值。
element optional
類型：Element optional
這是唯讀欄位。支援檢視畫面的 DOM 元素。
glyph optional
類型：string|Element|URL optional
圖釘中顯示的 DOM 元素。
glyphColor optional
類型：string optional
字符的顏色。支援任何 CSS 色彩值。
scale optional
類型：number optional
預設：1
圖釘的縮放比例。