MarkerOptions

public final 类 MarkerOptions扩展对象
实现 Parcelable

定义标记的 MarkerOptions。

开发者指南

如需了解详情,请参阅标记开发者指南。

继承的常量摘要

公共构造函数摘要

MarkerOptions()
用于创建一组新的标记选项。

公共方法摘要

MarkerOptions
alpha(浮点型 Alpha 版)
设置标记的 Alpha 值(不透明度)。
MarkerOptions
anchor(float u, float v)
用于指定要位于标记图像中特定点的锚点。
MarkerOptions
collisionBehavior(int collisionBehavior)
设置标记的冲突状态。
MarkerOptions
draggable(布尔值可拖动)
设置标记的可拖动性。
MarkerOptions
flat(布尔值平面)
设置此标记是贴于地图 true 的平面,还是朝向相机 false 的广告牌。
浮点数
getAlpha()
获取为此 MarkerOptions 对象设置的 alpha 值。
浮点数
getAnchorU()
锚点与左边缘之间的水平距离(标准化为 [0, 1])。
浮点数
getAnchorV()
锚点与上边缘之间的垂直距离(标准化为 [0, 1])。
整型
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
rotation(浮动旋转)
用于设置标记围绕标记的锚点顺时针旋转的角度(以度为单位)。
MarkerOptions
snippet(String snippet)
设置标记的代码段。
MarkerOptions
title(String title)
设置标记的标题。
MarkerOptions
visible(布尔值 visible)
设置标记的可见性。
MarkerOptions
zIndex(浮点数 zIndex)
设置标记的 zIndex。

继承的方法摘要

公共构造函数

public MarkerOptions ()

用于创建一组新的标记选项。

公共方法

public MarkerOptions alpha (浮动 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] 范围内)表示
返回
  • 为其调用方法的对象,并设置新的锚点。

public MarkerOptions collisionBehavior (int collisionBehavior)

设置标记的冲突状态。这是一个 Marker.CollisionBehavior 值。只能设置一次。

参数
collisionBehavior
返回
  • 调用方法的对象,并设置碰撞状态。

public MarkerOptions draggable (boolean draggable)

设置标记的可拖动性。

参数
可拖动
返回
  • 方法被调用的对象,并设置新的可拖动状态。

public MarkerOptions flat (布尔值平面)

设置此标记是贴于地图 true 的平面,还是朝向相机 false 的广告牌。如果在地图上是 Flat 标记,则当镜头旋转和倾斜时,标记会固定在地图上,但与 GroundOverlay 不同,该标记的大小仍会随着镜头缩放而改变大小。如果标记是广告牌,它将始终朝向镜头绘制,并随镜头旋转和倾斜。默认值为 false

参数
flat
返回
  • 方法被调用的对象,并设置新的平面状态。

public float getAlpha ()

获取为此 MarkerOptions 对象设置的 alpha 值。

返回
  • 标记的 Alpha 值,范围为 [0, 1]。

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 对象设置的旋转角度。

返回
  • 标记与默认位置所呈顺时针旋转角度(以度为单位)。

public String getSnippet ()

获取为此 MarkerOptions 对象设置的代码段。

返回
  • 包含标记摘要的字符串。

public String getTitle ()

获取为此 MarkerOptions 对象设置的标题。

返回
  • 包含标记标题的字符串。

公共 浮点数 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 boolean isDraggable ()

获取此 MarkerOptions 对象的可拖动性设置。

返回
  • 如果标记可拖动,则返回 true;否则返回 false

public boolean isFlat ()

获取此 MarkerOptions 对象的平面设置。

返回
  • 如果标记相对于地图是平面的,则为 true;如果标记应朝向镜头,则为 false

public boolean isVisible ()

获取此 MarkerOptions 对象的可见性设置。

返回
  • 如果标记可见,则返回 true;否则返回 false

public MarkerOptions position (LatLng latlng)

设置标记的位置。

参数
经纬度
返回
  • 方法被调用的对象,并设置新的位置。

public MarkerOptions rotation (浮点旋转)

用于设置标记围绕标记的锚点顺时针旋转的角度(以度为单位)。旋转轴与标记垂直。旋转角度为 0 对应于标记的默认位置。当地图上的标记为 Flat 标记时,默认位置为朝北,旋转角度会使标记始终在地图上保持扁平状态。当标记是广告牌时,默认位置是朝上,而且旋转时标记始终朝向镜头。默认值为 0。

参数
旋转
返回
  • 该方法被调用的对象,并设置新的旋转角度。

public MarkerOptions snippet (String snippet)

设置标记的代码段。

参数
snippet
返回
  • 方法被调用的对象,并设置新的代码段。

public MarkerOptions title (String title)

设置标记的标题。

参数
标题
返回
  • 此方法被调用的对象,并设置新的标题。

public MarkerOptions visible (boolean visible)

设置标记的可见性。

参数
visible
返回
  • 此方法被调用的对象,并设置新的可见性状态。

public MarkerOptions zIndex (浮点型 zIndex)

设置标记的 zIndex。

参数
zIndex
返回
  • 方法被调用的对象,并设置新的 zIndex。