MarkerOptions

公開最終類別 MarkerOptions 擴充物件
導入 Parcelable

定義標記的 MarkerOptions。

開發人員指南

詳情請參閱「標記」開發人員指南。

繼承常數摘要

公用建構函式摘要

MarkerOptions()
建立一組新的標記選項。

公用方法摘要

MarkerOptions
alpha(float alpha)
設定標記的 alpha (不透明度)。
MarkerOptions
anchor(float u, float v)
指定標記圖片中特定點的錨點。
MarkerOptions
collisionBehavior(int collisionBehavior)
設定標記的衝突狀態。
MarkerOptions
draggable(布林值可拖曳)
設定標記的可拖曳性。
MarkerOptions
扁平化(布林值平坦)
設定這個標記應平放於地圖 true,還是面向攝影機 false 的看板。
浮點值
getAlpha()
取得此 MarkerOptions 物件的 Alpha 集。
浮點值
getAnchorU()
從左側邊緣正規化為錨點的水平距離 (正規化為 [0, 1])。
浮點值
getAnchorV()
從上方邊緣正規化為錨點的垂直距離 (正規化為 [0, 1])。
int
BitmapDescriptor
getIcon()
取得這個 MarkerOptions 物件的自訂圖示描述元集。
浮點值
getInfoWindowAnchorU()
水平距離,由左側邊緣正規化為 [0, 1] 的資訊視窗錨點。
浮點值
getInfoWindowAnchorV()
從上方邊緣將資訊視窗錨定點的垂直距離正規化為 [0, 1]。
LatLng
getPosition()
傳回為這個 MarkerOptions 物件設定的位置。
浮點值
getRotation()
取得這個 MarkerOptions 物件的旋轉設定。
字串
getSnippet()
取得這個 MarkerOptions 物件的程式碼片段組合。
字串
getTitle()
取得為此 MarkerOptions 物件設定的標題。
浮點值
getZIndex()
取得這個 MarkerOptions 物件的 zIndex 集。
MarkerOptions
icon(BitmapDescriptor iconDescriptor)
設定標記的圖示。
MarkerOptions
infoWindowAnchor(float u, float v)
指定標記圖片上資訊視窗的錨點。
布林值
isDraggable()
取得這個 MarkerOptions 物件的可拖曳設定。
布林值
isFlat()
取得此 MarkerOptions 物件的平面設定。
布林值
isVisible()
取得這個 MarkerOptions 物件的瀏覽權限設定。
MarkerOptions
position(LatLng latlng)
設定標記的位置。
MarkerOptions
旋轉(浮點旋轉)
設定標記的錨點,以順時針角度設定標記的旋轉角度。
MarkerOptions
snippet(字串片段)
設定標記的程式碼片段。
MarkerOptions
title(字串標題)
設定標記的標題。
MarkerOptions
visible(布林值可見)
設定標記的顯示設定。
MarkerOptions
zIndex(float zIndex)
設定標記的 zIndex。

繼承方法摘要

公用建構函式

public MarkerOptions ()

建立一組新的標記選項。

公用方法

public MarkerOptions alpha (float alpha)

設定標記的 alpha (不透明度)。這個值的範圍介於 0 到 1 之間,其中 0 代表標記完全透明,1 則代表標記完全不透明。

參數
Alpha 版
傳回
  • 呼叫方法時要使用的物件,並使用新的 Alpha 集。

public MarkerOptions anchor (float u, float v)

指定錨點在標記圖片中的特定點。

錨點會指定圖示圖片中的點,該點會固定在地球表面上的標記位置。

錨點會在連續空間 [0.0, 1.0] x [0.0, 1.0] 中指定,其中 (0, 0) 是圖片的左上角,(1, 1) 則是右下角。W x H 圖片中的錨點是 (W + 1) x (H + 1) 格線中最接近的獨立格線點,可透過縮放再四捨五入取得。舉例來說,在一張 4 x 2 的圖片中,錨點 (0.7, 0.6) 會解析為格線的位置 (3, 1)。

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*
 

參數
u 錨點的 u 座標,以圖片寬度的比例 (在 [0, 1] 範圍內) 表示。
v 錨點的 v 座標,以圖片高度的比例 (在範圍 [0, 1] 範圍內) 表示。
傳回
  • 呼叫該方法的物件,並加上新的錨點。

公開 MarkerOptions collisionBehavior (int collisionBehavior)

設定標記的衝突狀態。這個值是 Marker.CollisionBehavior。只能設定一次。

參數
collisionBehavior
傳回
  • 呼叫方法的物件,並設定衝突狀態。

公開 MarkerOptions draggable (boolean draggable)

設定標記的可拖曳性。

參數
可拖曳
傳回
  • 呼叫該方法的物件,並設定新的可拖曳狀態。

公開 MarkerOptions flat (布林值扁平)

設定這個標記應平放於地圖 true,還是面向攝影機 false 的看板。如果標記是平放在地圖上,當相機旋轉和傾斜時,標記仍會卡住在地圖上,但其尺寸仍與相機縮放相同,但與 GroundOverlay 不同。如果標記為看板,則繪製時一律會面向攝影機,且會隨相機旋轉或傾斜。預設值為 false

參數
平盤
傳回
  • 呼叫方法的物件,設有新的平面狀態集。

public float getAlpha ()

取得此 MarkerOptions 物件的 Alpha 集。

傳回
  • 範圍 [0, 1] 範圍內的標記 Alpha 值。

public float getAnchorU ()

從左側邊緣正規化為錨點的水平距離 (正規化為 [0, 1])。

傳回
  • 錨定標記的 u 值。

public float getAnchorV ()

從上方邊緣正規化為錨點的垂直距離 (正規化為 [0, 1])。

傳回
  • 錨定標記的 v 值。

public int getCollisionBehavior ()

public BitmapDescriptor getIcon ()

取得這個 MarkerOptions 物件的自訂圖示描述元集。

傳回
  • 代表自訂圖示的 BitmapDescriptor;如未設定自訂圖示,則為 null

public float getInfoWindowAnchorU ()

水平距離,由左側邊緣正規化為 [0, 1] 的資訊視窗錨點。

傳回
  • 資訊視窗錨定標記的 u 值。

public float getInfoWindowAnchorV ()

從上方邊緣將資訊視窗錨定點的垂直距離正規化為 [0, 1]。

傳回
  • 資訊視窗錨定的 v 值。

public LatLng getPosition ()

傳回為這個 MarkerOptions 物件設定的位置。

傳回
  • 指定標記目前位置的 LatLng 物件。

public float getRotation ()

取得這個 MarkerOptions 物件的旋轉設定。

傳回
  • 標記從預設位置順時針旋轉角度。

公開 字串 getSnippet ()

取得這個 MarkerOptions 物件的程式碼片段組合。

傳回
  • 包含標記程式碼片段的字串。

公開字串 getTitle ()

取得為此 MarkerOptions 物件設定的標題。

傳回
  • 包含標記標題的字串。

public float getZIndex ()

取得這個 MarkerOptions 物件的 zIndex 集。

傳回
  • 標記的 zIndex。

public MarkerOptions icon (BitmapDescriptor iconDescriptor)

設定標記的圖示。

參數
iconDescriptor 如果為 null,則會使用預設標記。
傳回
  • 呼叫該方法的物件,並套用新的圖示描述元集。

public MarkerOptions infoWindowAnchor (float u, float v)

指定標記圖片上資訊視窗的錨點。是在與錨點相同的座標系統中指定。詳情請參閱 anchor(float, float)。預設值為圖片的頂部中間。

參數
u 資訊視窗錨定的 u 座標,以圖片寬度的比例 (在 [0, 1] 範圍內) 為準。
v 資訊視窗錨點的 v 座標,以圖片高度的比例 (在 [0, 1] 範圍內) 為準
傳回
  • 呼叫方法的物件,並設定新的資訊視窗錨點。

public 布林值 isDraggable ()

取得這個 MarkerOptions 物件的可拖曳設定。

傳回
  • 如果標記可拖曳,則為 true;否則會傳回 false

公開布林值 isFlat ()

取得此 MarkerOptions 物件的平面設定。

傳回
  • 如果標記平放於地圖,則為 true;如果標記應面向攝影機,則為 false

public boolean isVisible ()

取得這個 MarkerOptions 物件的瀏覽權限設定。

傳回
  • 如果會顯示標記,則為 true;否則會傳回 false

public MarkerOptions position (LatLng latlng)

設定標記的位置。

參數
經緯度
傳回
  • 呼叫方法的物件,並設定新的位置。

公開 MarkerOptions 旋轉 (浮點旋轉)

設定標記的錨點,以順時針角度設定標記的旋轉角度。旋轉軸與標記垂直。旋轉 0 對應標記的預設位置。如果標記平放在地圖上,預設方向為朝北對齊,且旋轉時標記始終在地圖上固定。標記為看板時,預設方向為朝上,且旋轉時標記始終面對攝影機。預設值為 0。

參數
旋轉
傳回
  • 呼叫方法的物件,具有新的旋轉集。

public MarkerOptions snippet (字串片段)

設定標記的程式碼片段。

參數
摘要
傳回
  • 呼叫該方法的物件,並搭配新的程式碼片段。

public MarkerOptions title (字串標題)

設定標記的標題。

參數
title
傳回
  • 呼叫方法的物件,並採用新的標題集。

public MarkerOptions visible (boolean visible)

設定標記的顯示設定。

參數
顯示
傳回
  • 呼叫方法的物件,並設定新的瀏覽權限狀態。

public MarkerOptions zIndex (float zIndex)

設定標記的 zIndex。

參數
zIndex
傳回
  • 呼叫方法的物件 (使用新的 zIndex)。