Marker

Marker 類別

google.maps.Marker 類別

這個類別會擴充 MVCObject

呼叫 const {Marker} = await google.maps.importLibrary("marker") 即可存取。請參閱 Maps JavaScript API 中的程式庫

Marker
Marker([opts])
參數: 
使用指定的選項建立一個標記。如果指定地圖,系統會在建立地圖時將標記加進地圖。請注意,必須為標記設定要顯示的位置。
MAX_ZINDEX API 將會指派給標記的最大預設 Z 索引。您可以設定較高的 Z 索引,將標記置於最前方。
getAnimation
getAnimation()
參數:
傳回值:  Animation|null|undefined
取得目前執行中的動畫。
getClickable
getClickable()
參數:
傳回值:如果標記可點擊,則為 boolean True。
取得 Marker 的可點擊狀態。
getCursor
getCursor()
參數:
傳回值:  string|null|undefined
取得遊標懸停時顯示的滑鼠遊標類型。
getDraggable
getDraggable()
參數:
傳回值:如果標記可拖曳,boolean 則為 True。
取得 Marker 的可拖曳狀態。
getIcon
getIcon()
參數:
傳回值:  string|Icon|Symbol|null|undefined
取得 Marker 的圖示。查看《MarkerOptions.icon》。
getLabel
getLabel()
參數:
傳回值:  MarkerLabel|string|null|undefined
取得 Marker 的標籤。查看《MarkerOptions.label》。
getMap
getMap()
參數:
傳回值:  Map|StreetViewPanorama
取得算繪 Marker 的地圖或全景。
getOpacity
getOpacity()
參數:
傳回值:  number|null|undefined 介於 0.0 和 1.0 之間的數字。
取得 Marker 的不透明度。
getPosition
getPosition()
參數:
傳回值:  LatLng|null|undefined
取得 Marker 的位置。
getShape
getShape()
參數:
傳回值:  MarkerShape|null|undefined
取得用於互動的 Marker 形狀。請參閱《MarkerOptions.shapeMarkerShape》。
getTitle
getTitle()
參數:
傳回值:  string|null|undefined
取得 Marker 工具提示的標題。查看《MarkerOptions.title》。
getVisible
getVisible()
參數:
傳回值:如果顯示標記,則為 boolean
取得 Marker 的瀏覽權限。
getZIndex
getZIndex()
參數:
傳回值:  number|null|undefined 的 zIndex 值。
取得 Marker 的 zIndex。查看《MarkerOptions.zIndex》。
setAnimation
setAnimation([animation])
參數: 
  • animationAnimation optional要播放的動畫。
傳回值:None
啟動動畫。所有正在進行的動畫都會取消。目前支援的動畫為:Animation.BOUNCEAnimation.DROP。如果傳入 null,將會導致所有動畫停止。
setClickable
setClickable(flag)
參數: 
  • flagboolean如果為 true,可以點選標記。
傳回值:None
設定 Marker 是否可點擊。
setCursor
setCursor([cursor])
參數: 
  • cursorstring optional滑鼠遊標類型。
傳回值:None
設定懸停時顯示的滑鼠遊標類型。
setDraggable
setDraggable(flag)
參數: 
  • flagboolean optional如果為 true,則可拖曳標記。
傳回值:None
設定 Marker 是否可拖曳。
setIcon
setIcon([icon])
參數: 
傳回值:None
設定 Marker 的圖示。查看《MarkerOptions.icon》。
setLabel
setLabel([label])
參數: 
傳回值:None
設定 Marker 的標籤。查看《MarkerOptions.label》。
setMap
setMap(map)
參數: 
傳回值:None
在指定的地圖或全景上呈現 Marker。如果地圖設為 null,系統會移除標記。
setOpacity
setOpacity([opacity])
參數: 
  • opacitynumber optional介於 0.0、透明和 1.0 (不透明) 之間的數字。
傳回值:None
設定 Marker 的不透明度。
setOptions
setOptions(options)
參數: 
傳回值:None
設定 Marker 的選項。
setPosition
setPosition([latlng])
參數: 
傳回值:None
設定 Marker 的分區。
setShape
setShape([shape])
參數: 
傳回值:None
設定用於互動的 Marker 形狀。請參閱《MarkerOptions.shapeMarkerShape》。
setTitle
setTitle([title])
參數: 
  • titlestring optional
傳回值:None
設定 Marker 工具提示的標題。查看《MarkerOptions.title》。
setVisible
setVisible(visible)
參數: 
  • visibleboolean如果為 true,則顯示標記
傳回值:None
設定是否顯示 Marker
setZIndex
setZIndex([zIndex])
參數: 
  • zIndexnumber optional
傳回值:None
設定 Marker 的 zIndex。查看《MarkerOptions.zIndex》。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
animation_changed
function()
引數:
Marker 動畫屬性變更時,會觸發此事件。
click
function(event)
引數: 
按一下 Marker 圖示時,會觸發此事件。
clickable_changed
function()
引數:
Marker 可點擊屬性變更時,會觸發此事件。
contextmenu
function(event)
引數: 
Marker 上觸發 DOM contextmenu 事件時,會觸發此事件
cursor_changed
function()
引數:
Marker 遊標屬性變更時,會觸發此事件。
dblclick
function(event)
引數: 
按兩下 Marker 圖示時,會觸發此事件。
drag
function(event)
引數: 
使用者拖曳 Marker 時,系統會重複觸發這個事件。
dragend
function(event)
引數: 
使用者停止拖曳 Marker 時,會觸發此事件。
draggable_changed
function()
引數:
Marker 可拖曳的屬性變更時,會觸發此事件。
dragstart
function(event)
引數: 
使用者開始拖曳 Marker 時,就會觸發此事件。
flat_changed
function()
引數:
Marker 平面屬性變更時,會觸發此事件。
icon_changed
function()
引數:
Marker 圖示屬性變更時,會觸發此事件。
mousedown
function(event)
引數: 
Marker 上的 mousedown 會觸發此事件。
mouseout
function(event)
引數: 
滑鼠離開 Marker 圖示的區域時,會觸發此事件。
mouseover
function(event)
引數: 
滑鼠進入 Marker 圖示的區域時,會觸發此事件。
mouseup
function(event)
引數: 
Marker 上出現 Mouseup 時,會觸發此事件。
position_changed
function()
引數:
Marker 位置屬性變更時,會觸發此事件。
shape_changed
function()
引數:
Marker 形狀屬性變更時,會觸發此事件。
title_changed
function()
引數:
Marker 標題屬性變更時,會觸發此事件。
visible_changed
function()
引數:
Marker 可見屬性變更時,會觸發此事件。
zindex_changed
function()
引數:
Marker zIndex 屬性變更時,會觸發此事件。
rightclick
function(event)
引數: 
Marker 按一下滑鼠右鍵,就會觸發此事件。

MarkerOptions 介面

google.maps.MarkerOptions 介面

MarkerOptions 物件,用來定義可對 Marker 設定的屬性。

anchorPoint optional
類型:  Point optional
標記位置與 InfoWindow 尖端的偏移值 (已開啟標記為錨點)。
animation optional
類型:  Animation optional
預設值: null
在地圖中新增標記時所要播放的動畫。
clickable optional
類型:  boolean optional
預設值: true
如果為 true,標記會接收滑鼠和觸控事件。
BetacollisionBehavior optional
類型:  string|CollisionBehavior optional
預設值: null
設定向量地圖上的標記衝突行為。
crossOnDrag optional
類型:  boolean optional
預設值: true
如果為 false,在拖曳時停用標記下方顯示的交叉點。
cursor optional
類型:  string optional
預設值: pointer
懸停時要顯示的滑鼠遊標類型。
draggable optional
類型:  boolean optional
預設值: false
如果為 true,則可拖曳標記。
icon optional
類型:  string|Icon|Symbol optional
前景的圖示。如果提供字串,系統會將該字串視為 Icon,且字串為 url
label optional
類型:  string|MarkerLabel optional
預設值: null
為標記新增標籤。標記標籤是顯示在標記內的字母或數字。標籤可以是字串或 MarkerLabel 物件。如未提供 MarkerOptions.title,系統將在標記中加入無障礙文字 (例如用於螢幕閱讀器) 和提供的標籤文字。請注意,label 目前僅適用於未經最佳化的標記的無障礙文字。
map optional
類型:  Map|StreetViewPanorama optional
要顯示標記的地圖。地圖必須顯示標記,如果建立標記時沒有提供,則可透過 Marker.setMap 提供。
opacity optional
類型:  number optional
預設值:1.0
介於 0.0、透明和 1.0 (不透明) 之間的數字。
optimized optional
類型:  boolean optional
您可進行最佳化處理來將多個標記算繪為單一靜態元素,藉此提升效能。這個做法在需要使用大量標記時相當實用。進一步瞭解標記最佳化
position optional
類型:  LatLng|LatLngLiteral optional
設定標記位置。您只能建構標記,但在提供標記位置 (例如由使用者的動作或選項) 之前都不會顯示。如果建立標記時沒有提供標記位置,則可使用 Marker.setPosition 提供標記位置。
shape optional
類型:  MarkerShape optional
用於拖曳/點擊的圖片地圖區域定義。
title optional
類型:  string optional
預設值: undefined
滑鼠遊標懸停效果文字。如有提供,將在標記中加入無障礙文字 (例如用於螢幕閱讀器的文字),以及提供的值。請注意,title 目前僅適用於未經最佳化的標記的無障礙文字。
visible optional
類型:  boolean optional
預設值: true
如果為 true,則顯示標記。
zIndex optional
類型:  number optional
所有標記都會依其 zIndex 順序顯示,較大的標記值會顯示在值較小的標記值之前。根據預設,標記會依據其在畫面上的垂直位置顯示,而較小的標記將會顯示在畫面上方的標記之前。

衝突行為常數

google.maps.CollisionBehavior 常數

呼叫 const {CollisionBehavior} = await google.maps.importLibrary("marker") 即可存取。請參閱 Maps JavaScript API 中的程式庫

OPTIONAL_AND_HIDES_LOWER_PRIORITY 只有在標記沒有與其他標記重疊時,才顯示標記。如果這個類型的兩個標記重疊,系統會顯示 zIndex 值較高的標記。如果兩者的 zIndex 相同,系統會顯示直向畫面位置較低的 zIndex。
REQUIRED 無論是哪一種衝突,一律顯示標記。此為預設行為。
REQUIRED_AND_HIDES_OPTIONAL 無論是哪一種衝突,一律顯示標記,並隱藏與標記重疊的所有 OPTIONAL_AND_HIDES_LOWER_PRIORITY 標記或標籤。

Icon 介面

google.maps.Icon 介面

代表「標記」圖示圖片的結構。

url
類型:  string
圖片或綜合連續圖片的網址。
anchor optional
類型:  Point optional
根據標記在地圖上的位置,固定圖片的位置。錨點的預設位置在圖片下方的中心點。
labelOrigin optional
類型:  Point optional
標記相對於圖示圖片左上角的標籤來源 (如果標記由標記提供)。起點的預設位置在圖片的中心點。
origin optional
類型:  Point optional
綜合圖片內圖片的位置 (如果有)。起點的預設位置在圖片 (0, 0) 的左上角。
scaledSize optional
類型:  Size optional
縮放之後整個圖片的大小 (如果有)。您可以使用此屬性拉伸/縮短圖片或綜合圖片。
size optional
類型:  Size optional
綜合圖片或圖片的顯示大小。使用綜合圖片時,您必須指定綜合圖片的大小。如未提供大小,系統會在載入圖片時加以設定。

MarkerLabel 介面

google.maps.MarkerLabel 介面

這些選項可指定標記標籤的外觀。標記標籤是會顯示在標記中的字串 (通常是單一字元)。搭配自訂標記使用時,您可以透過 Icon 類別中的 labelOrigin 屬性重新調整其位置。

text
類型:  string
要在標籤中顯示的文字。
className optional
類型:  string optional
預設: '' (空字串)
標籤元素的 className 屬性 (相當於元素的類別屬性)。您可以新增多個以空格分隔的 CSS 類別。字型顏色、大小、粗細和系列只能透過 MarkerLabel 的其他屬性設定。如果您也使用標記衝突管理,就不應使用 CSS 類別來變更標籤的位置和方向 (例如使用翻譯和旋轉)。
color optional
類型:  string optional
預設值: 'black'
標籤文字的顏色。
fontFamily optional
類型:  string optional
標籤文字的字型系列 (等同 CSS 字型系列屬性)。
fontSize optional
類型:  string optional
預設值: '14px'
標籤文字的字型大小 (等同 CSS 字型大小屬性)。
fontWeight optional
類型:  string optional
標籤文字的字型粗細 (等 CSS 字型重量屬性)。

MarkerShape 介面

google.maps.MarkerShape 介面

這個物件會定義標記圖片的可點擊區域。形狀包含兩種屬性:typecoord,用於定義圖片的不透明區域。

coords
類型:  Array<number>
此屬性的格式取決於 type 的值,並遵循 w3 AREA coords 規格,詳情請參閱 http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords
coords 屬性是整數陣列,用於指定與目標圖片左上角的形狀像素位置。座標取決於 type 的值,如下所示:
- circle:座標為 [x1,y1,r],其中 x1,y2 是圓形中心的座標,r 則是圓形半徑。
- poly:座標為 [x1,y1,x2,y2...xn,yn],其中每個 x,y 組合都包含多邊形單一端點的座標。
- rect:座標為 [x1,y1,x2,y2],其中 x1,y1 是矩形左上角的座標,x2,y2 則是矩形右下角的座標。
type
類型:  string
說明形狀的類型,可能是 circlepolyrect

Symbol 介面

google.maps.Symbol 介面

描述符號,由具有樣式的向量路徑所組成。符號可做為標記的圖示,或放置在折線上。

path
類型:  SymbolPath|string
符號的路徑,為內建符號路徑,或使用 SVG 路徑標記法表示的自訂路徑。這是必填欄位。
anchor optional
類型:  Point optional
預設值: google.maps.Point(0,0)
相對於標記或折線的符號位置。符號的路徑座標會分別根據錨點的 x 和 y 座標轉譯成左方和上方的位置。位置使用與符號路徑相同的座標系統表示。
fillColor optional
類型:  string optional
符號的填滿顏色。系統支援所有 CSS3 色彩 (延伸的具名色彩除外)。標記上符號的預設為「黑色」。折線上的符號則預設為相應折線的線條顏色。
fillOpacity optional
類型:  number optional
預設值: 0
符號的填滿透明度。
labelOrigin optional
類型:  Point optional
預設值: google.maps.Point(0,0)
標籤相對於路徑起點的標籤來源 (如果標記由標記提供)。起點使用與符號路徑相同的座標系統表示。折線上的符號未使用這個屬性。
rotation optional
類型:  number optional
預設值: 0
符號的順時針旋轉角度。IconSequence 中的符號,其中 fixedRotationfalse 是根據其所在邊緣的角度而旋轉。
scale optional
類型:  number optional
符號的大小縮放比例。標記上符號的預設為 1;縮放後,符號的尺寸可以是任何大小。折線上的符號則預設為折線的線條粗細;縮放後,符號必須落在正方形的 22 像素內,大小須位於符號錨點的中央。
strokeColor optional
類型:  string optional
符號的筆觸顏色。系統支援所有 CSS3 色彩 (延伸的具名色彩除外)。標記上符號的預設為「黑色」。折線上的符號則預設為折線的線條顏色。
strokeOpacity optional
類型:  number optional
符號的筆觸不透明度。標記上符號的預設為 1。折線上的符號則預設為折線的線條不透明度。
strokeWeight optional
類型:  number optional
預設值:符號的 Symbol.scale
符號的筆觸粗細。

SymbolPath 常數

google.maps.SymbolPath 常數

內建符號路徑。

呼叫 const {SymbolPath} = await google.maps.importLibrary("core") 即可存取。請參閱 Maps JavaScript API 中的程式庫

BACKWARD_CLOSED_ARROW 向後方的封閉箭頭。
BACKWARD_OPEN_ARROW 指向後方的開放箭頭。
CIRCLE 圓形。
FORWARD_CLOSED_ARROW 指向前方的封閉箭頭。
FORWARD_OPEN_ARROW 指向前方的箭頭。

動畫常數

google.maps.Animation 常數

可在標記上播放的動畫。在標記上使用 Marker.setAnimation 方法或 MarkerOptions.animation 選項即可播放動畫。

呼叫 const {Animation} = await google.maps.importLibrary("marker") 即可存取。請參閱 Maps JavaScript API 中的程式庫

BOUNCE 標記會跳出,直到以 null 呼叫 Marker.setAnimation 停止動畫為止。
DROP 標記會從地圖頂端落到最終位置。當標記停止時,動畫會停止,Marker.getAnimation 則會傳回 null。這種類型的動畫通常會在建立標記時指定。