目录

Marker

Class Info

public class Marker

放在地图指定位置的图标,在调用HuaweiMap类的addMarker方法时会返回该类型的实例。

Public Method Summary

Qualifier and Type

Method Name and Description

float

getAlpha()

获取标记的透明度。

LatLng

getPosition()

获取标记的位置。

float

getRotation()

获取标记的旋转角度。

String

getSnippet()

获取标记的文字片段。

Object

getTag()

获取标记的tag属性。

String

getTitle()

获取标记的标题。

float

getZIndex()

获取标记的z指数。

void

hideInfoWindow()

隐藏标记的标记信息窗口。

boolean

isClickable()

获取标记是否可以点击。

boolean

isClusterable()

获取标记的聚合属性。

boolean

isDraggable()

获取标记是否可以长按拖拽。

boolean

isFlat()

获取标记是否平贴地图。

boolean

isInfoWindowShown()

获取标记的标记信息窗口是否在展示状态。

boolean

isVisible()

获取标记的可见性。

void

remove()

从地图移除标记。

void

setAlpha(float alpha)

设置标记的透明度属性。

void

setAnchor(float anchorU, float anchorV)

设置标记的锚点位置。

注意:

该接口已弃用,设置锚点位置请使用setMarkerAnchor。

void

setAnimation(Animation animation)

设置标记的动画。

void

setClickable(boolean clickable)

设置标记是否可点击。

void

setDraggable(boolean draggable)

设置标记是否可以长按拖拽。

void

setFlat(boolean flat)

设置标记是否平贴地图。

void

setIcon(BitmapDescriptor iconDescriptor)

设置标记的图标。

void

setInfoWindowAnchor(float anchorU, float anchorV)

设置标记的标记信息窗口的锚点坐标, 这是在与锚点相同的坐标系中指定的, 默认值为标记图像的顶部中间。

void

setMarkerAnchor(float anchorU, float anchorV)

设置标记的锚点位置。

void

setPosition(LatLng latLng)

设置标记的位置坐标。

void

setRotation(float rotation)

设置标记的旋转角度,即标记围绕标记锚点顺时针旋转的角度,旋转轴垂直于标记。

void

setSnippet(String snippet)

设置标记的文字片段,如果为空,则不显示文字片段。

void

setTag(Object tag)

设置标记的tag属性,如果为空,则清除tag。

void

setTitle(String title)

设置标记的标题,默认为空。

void

setVisible(boolean visible)

设置标记的可见性。

void

setZIndex(float zIndex)

设置标记的z指数。

void

showInfoWindow()

展示标记的标记信息窗口。

void

startAnimation()

使标记开始动画。

Public Methods

[h2]getAlpha

Method

public float getAlpha()

您调用此API可以获取标记的透明度。

Returns

Type

Description

float

标记的透明度,取值范围:[0, 1]。

[h2]getPosition

Method

public final LatLng getPosition()

您调用此API可以获取标记的位置。

Returns

Type

Description

LatLng

标记的位置。

[h2]getRotation

Method

public final float getRotation()

您调用此API可以获取标记的旋转角度。

Returns

Type

Description

float

标记的旋转角度。

[h2]getSnippet

Method

public final String getSnippet()

您调用此API可以获取标记的文字片段。

Returns

Type

Description

String

标记的文字片段。

[h2]getTag

Method

public Object getTag()

您调用此API将获取标记的tag属性(如果标记的tag属性已被设置)。

Returns

Type

Description

Object

标记的tag属性。如果已设置tag,则返回Object;如果未设置,则返回null。

[h2]getTitle

Method

public final String getTitle()

您调用此API可以获取标记的标题。

Returns

Type

Description

String

标记的标题,字符串对象。

[h2]getZIndex

Method

public float getZIndex()

您调用此API可以获取标记的z指数。

Returns

Type

Description

float

z指数,即标记的叠加顺序。

[h2]hideInfoWindow

Method

public final void hideInfoWindow()

您调用此API时可以隐藏标记的标记信息窗口,如果标记显示了信息窗口,则将其隐藏。如果标记不可见,则此方法无效。

[h2]isClickable

Method

public boolean isClickable()

您调用此API可以获取标记是否可以点击。

Returns

Type

Description

boolean

表示是否可以点击。

  • true:可以
  • false:不可以

[h2]isClusterable

Method

public boolean isClusterable()

您调用此API可以获取标记的聚合属性。

Returns

Type

Description

boolean

表示该标记是否可聚合。

  • true:可聚合
  • false:不可聚合

[h2]isDraggable

Method

public final boolean isDraggable()

您调用此API可以获取标记是否可以长按拖拽。

Returns

Type

Description

boolean

表示是否可以长按拖拽。

  • true:可以
  • false:不可以

[h2]isFlat

Method

public final boolean isFlat()

您调用此API可以获取标记是否平贴地图。

Returns

Type

Description

boolean

表示是否平贴地图。

  • true:平贴地图
  • false:面对相机

[h2]isInfoWindowShown

Method

public final boolean isInfoWindowShown()

您调用此API可以获取标记的标记信息窗口是否在展示状态,这不会考虑标记信息窗口在屏幕上是否实际可见。

Returns

Type

Description

boolean

表示标记信息窗口是否可见。

  • true:可见
  • false:不可见

[h2]isVisible

Method

public final boolean isVisible()

您调用此API可以获取标记的可见性。

Returns

Type

Description

boolean

标记的可见性。

  • true:可见
  • false:不可见

[h2]remove

Method

public final void remove()

您调用此API可以从地图移除标记。

[h2]setAlpha

Method

public final void setAlpha(float alpha)

您调用此API可以设置标记的透明度属性。

Parameters

Name

Description

alpha

透明度,取值范围:[0, 1]。

  • 0:完全透明。
  • 1:完全不透明。

默认值为1。

[h2]setAnchor

该接口已弃用,设置锚点位置请使用setMarkerAnchor。

Method

public final void setAnchor(float anchorU, float anchorV)

您调用此API可以设置标记的锚点位置。当前已设置u,v固定值,所以该接口固定锚点位置为标记图标的底部。

Parameters

Name

Description

anchorU

锚点的水平坐标,以图像宽度的比例,在[0, 1]范围内。默认值为0.5。

anchorV

锚点的垂直坐标,以图像高度的比例,在[0, 1]范围内。默认值为0.5。

[h2]setAnimation

Method

public void setAnimation(Animation animation)

您调用此API可以设置标记的动画。

Parameters

Name

Description

animation

动画。

[h2]setClickable

Method

public void setClickable(boolean clickable)

您调用此API可以设置标记是否可以点击。

Parameters

Name

Description

clickable

设置标记是否可以点击,默认是true。

  • true:可以
  • false:不可以

[h2]setDraggable

Method

public final void setDraggable(boolean draggable)

您调用此API可以设置标记是否可以长按拖拽。

Parameters

Name

Description

draggable

是否可以长按拖拽。

  • true:可以
  • false:不可以

默认值为false。

[h2]setFlat

Method

public final void setFlat(boolean flat)

您调用此API可以设置标记是否平贴地图。如果标记平贴地图,则在相机旋转和倾斜时,标记仍将停留在地图上,但与GroundOverlay不同,它将保持与照相机缩放时相同的大小。 如果标记面对相机,它将始终面向相机绘制,并随相机旋转和倾斜。

Parameters

Name

Description

flat

  • true:平贴地图
  • false:面对相机

默认值为false。

[h2]setIcon

Method

public final void setIcon(BitmapDescriptor iconDescriptor)

您调用此API可以设置标记的图标,如果为空,则使用默认标记。

Parameters

Name

Description

iconDescriptor

包含图标的对象。

[h2]setInfoWindowAnchor

Method

public final void setInfoWindowAnchor(float anchorU, float anchorV)

您调用此API可以设置标记的标记信息窗口的锚点坐标, 这是在与锚点相同的坐标系中指定的, 默认值为标记图像的顶部中间。 有关更多详细信息,请参见setMarkerAnchor(float anchorU, float anchorV)。

Parameters

Name

Description

anchorU

标记信息窗口锚点的水平坐标,以图像宽度的比例,建议取值[0, 1]。

anchorV

标记信息窗口锚点的垂直坐标,以图像高度的比例,建议取值[0, 1]。

[h2]setMarkerAnchor

Method

public final void setMarkerAnchor(float anchorU, float anchorV)

您调用此API可以设置标记的锚点位置。锚点是标记图标接触地图平面的点,图标的左顶点为(0, 0)点,右顶点为(1, 0)点,左底点为(0, 1)点,右底点为(1, 1)点。例如,在标记X(0.5, 0.3)处的锚点坐标如下:

Parameters

Name

Description

anchorU

锚点的水平坐标,以图像宽度的比例,建议取值[0, 1],默认值为0.5。

anchorV

锚点的垂直坐标,以图像高度的比例,建议取值[0, 1],默认值为1。

[h2]setPosition

Method

public final void setPosition(LatLng latLng)

您调用此API可以设置标记的位置坐标。

Parameters

Name

Description

latLng

标记的位置坐标。

Throws

Name

Description

IllegalArgumentException

当latlng为空时,抛出异常。

[h2]setRotation

Method

public final void setRotation(float rotation)

您调用此API可以设置标记的旋转角度,即标记围绕标记锚点顺时针旋转的角度,旋转轴垂直于标记。默认旋转角度为0,默认位置为北对齐。

Parameters

Name

Description

rotation

标记的旋转角度,默认值为0。

[h2]setSnippet

Method

public final void setSnippet(String snippet)

您调用此API可以设置标记的文字片段,如果为空,则不显示文字片段。

Parameters

Name

Description

snippet

文字片段。

[h2]setTag

Method

public final void setTag(Object tag)

您调用此API可以设置标记的tag属性,tag属性可以是任意对象,如果设置为空,则清除tag。当您不再需要使用tag时,您可以调用setTag(null)清除tag,以防止应用程序发生内存泄漏。

Parameters

Name

Description

tag

标记的tag属性。

[h2]setTitle

Method

public final void setTitle(String title)

您调用此API可以设置标记的标题,默认为空。

Parameters

Name

Description

title

标题,字符串对象,如果为空,则清除标题。

[h2]setVisible

Method

public final void setVisible(boolean visible)

您调用此API可以设置标记的可见性。

Parameters

Name

Description

visible

标记的可见性。

  • true:可见
  • false:不可见

默认值为true。

[h2]setZIndex

Method

public final void setZIndex(float zIndex)

用于设置标记的z指数。z指数指的是标记的叠加顺序,具有较大z指数的标记会绘制在具有较小z指数的标记上,具有相同z指数的叠加顺序为元素添加的先后顺序。

Parameters

Name

Description

zIndex

z指数,即标记的叠加顺序。默认的z指数是0。

注意:

当点击Marker时其层级将会被置顶,标记的z指数值被置为3.4028235E38。

[h2]showInfoWindow

Method

public final void showInfoWindow()

您调用此API可以展示标记的标记信息窗口。

[h2]startAnimation

Method

public void startAnimation()

您调用此API可以使标记开始动画。