Marker

java.lang.Object
- com.amap.api.maps.model.BaseOverlay
- - com.amap.api.maps.model.BasePointOverlay
  - - com.amap.api.maps.model.Marker

```
public final class Marker
extends BasePointOverlay
```
定义地图 Marker 覆盖物 Marker 是在地图上的一个点绘制图标。这个图标和屏幕朝向一致，和地图朝向无关，也不会受地图的旋转、倾斜、缩放影响。
一个marker有如下属性：
- 锚点：图标摆放在地图上的基准点。默认情况下，锚点是从图片下沿的中间处。
- 位置：marker是通过经纬度的值来标注在地图上的。
- 标题：当点击Marker 显示在信息窗口的文字，随时可以更改。
- 片段：除了标题外其他的文字，随时可以更改。
- 图标：Marker 显示的图标。如果未设置图标，API 将使用默认的图标，高德为默认图标提供了10 种颜色备选。默认情况下，Marker 是可见的。你们随时更改marker 的可见性。
从以下版本开始:

2.0

字段概要
- 从类继承的字段 com.amap.api.maps.model.BaseOverlay
  Field1, Field2, overlayName

方法概要

所有方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`void`	`destroy()` 删除当前marker并销毁Marker的图片等资源。
`boolean`	`equals(java.lang.Object other)`
`float`	`getAlpha()` 获取Marker覆盖物的透明度,透明度范围[0,1] 1为不透明,默认值为1
`float`	`getAltitude()` 获取marker海拔
`java.util.ArrayList<BitmapDescriptor>`	`getIcons()` 返回Marker动画帧的图标列表。
`java.lang.String`	`getId()` 返回Marker 的Id，每个marker 的唯一标识，用来区分不同的Marker。
`java.lang.Object`	`getObject()` 获取Marker覆盖物的附加信息对象，即自定义的Marker的属性。
`MarkerOptions`	`getOptions()` 获取Marker覆盖物的选项类
`int`	`getPeriod()` 得到多少帧刷新一次图片资源。
`LatLng`	`getPosition()` 获取 Marker 覆盖物的位置坐标。
`float`	`getRotateAngle()` 获取 Marker覆盖物的图片旋转角度，从正北开始，逆时针计算。
`java.lang.String`	`getSnippet()` 获取Marker 覆盖物的文字片段。
`java.lang.String`	`getTitle()` 获取Marker 覆盖物的标题。
`float`	`getZIndex()` 获取Marker覆盖物的z轴值。
`int`	`hashCode()`
`void`	`hideInfoWindow()` 隐藏Marker覆盖物的信息窗口。
`boolean`	`isClickable()` 获取Maker覆盖物的点击状态,可以通过 `Marker.setClickable(boolean)` 设置是否可以点击
`boolean`	`isDraggable()` 获得Marker覆盖物的拖拽状态。
`boolean`	`isFlat()` 返回Marker覆盖物是否是平贴在地图上。
`boolean`	`isInfoWindowEnable()` 获取Marker覆盖物是否允许InfoWindow显示, 可以通过 `Marker.setInfoWindowEnable(boolean)` 进行设置
`boolean`	`isInfoWindowShown()` 返回Marker覆盖物的信息窗口是否显示，true: 显示，false: 不显示。
`boolean`	`isPerspective()` 已过时。已取消这个效果
`boolean`	`isRemoved()` 获取当前Marker是否是被移除状态
`boolean`	`isVisible()` 返回Marker是否可见。
`void`	`remove()` 删除当前marker。
`void`	`setAlpha(float alpha)` 设置Marker覆盖物的透明度
`void`	`setAltitude(float altitude)` 设置marker海拔
`void`	`setAnchor(float anchorU, float anchorV)` 设置Marker覆盖物的锚点比例。
`void`	`setAnimation(Animation animation)` 设置动画,动画包含，旋转，缩放，消失，平移以及它们的组合动画
`void`	`setClickable(boolean clickable)` 设置Marker覆盖物是否可以点击
`void`	`setDraggable(boolean paramBoolean)` 设置Marker覆盖物是否允许拖拽。
`void`	`setFlat(boolean flat)` 设置Marker覆盖物是否平贴在地图上。
`void`	`setIcon(BitmapDescriptor icon)` 设置 Marker覆盖物的图标
`void`	`setIcons(java.util.ArrayList<BitmapDescriptor> icons)` 设置 Marker 的图标集合，相同图案的 icon 的 marker 最好使用同一个 BitmapDescriptor 对象以节省内存空间。
`void`	`setInfoWindowEnable(boolean enabled)` 设置Marker覆盖物的InfoWindow是否允许显示,默认为true 设置为false之后, 调用`Marker.showInfoWindow()` 将不会生效
`void`	`setMarkerOptions(MarkerOptions opt)` 设置Marker覆盖物的属性选项类通过markerOption 给marker设置属性
`void`	`setObject(java.lang.Object object)` 设置Marker覆盖物的附加信息对象。
`void`	`setPeriod(int period)` 设置多少帧刷新一次图片资源，Marker动画的间隔时间，值越小动画越快。
`void`	`setPerspective(boolean isPerspective)` 已过时。已取消这个效果
`void`	`setPosition(LatLng latlng)` 设置 Marker 覆盖物的位置坐标。
`void`	`setPositionByPixels(int x, int y)` 设置marker覆盖物在屏幕的像素坐标。
`void`	`setRotateAngle(float rotate)` 设置Marker覆盖物图片旋转的角度，从正北开始，逆时针计算。
`void`	`setSnippet(java.lang.String snippet)` 设置Marker 覆盖物的文字片段。
`void`	`setTitle(java.lang.String title)` 设置Marker 覆盖物的标题。
`void`	`setToTop()` 设置当前marker在最上面。
`void`	`setVisible(boolean visible)` 设置 Marker 覆盖物的可见属性。
`void`	`setZIndex(float zIndex)` 设置Marker覆盖物的z轴值。
`void`	`showInfoWindow()` 显示 Marker 覆盖物的信息窗口。
`boolean`	`startAnimation()` 开始动画

从类继承的方法 com.amap.api.maps.model.BasePointOverlay
setGeoPoint

从类继承的方法 com.amap.api.maps.model.BaseOverlay
method1, method2

从类继承的方法 java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - setPeriod
```
public void setPeriod(int period)
```
    设置多少帧刷新一次图片资源，Marker动画的间隔时间，值越小动画越快。默认为20，最小为1。
    
    参数:
    
    period - 刷新周期，越小速度越快。默认为20，最小为1。
    
    从以下版本开始:
    
    2.1.4
  - getPeriod
```
public int getPeriod()
```
    得到多少帧刷新一次图片资源。默认为20，最小为1。
    
    返回:
    
    刷新周期，速度越小速度越快。默认为20，最小为1。
    
    从以下版本开始:
    
    2.1.4
  - setIcons
```
public void setIcons(java.util.ArrayList<BitmapDescriptor> icons)
```
    设置 Marker 的图标集合，相同图案的 icon 的 marker 最好使用同一个 BitmapDescriptor 对象以节省内存空间。 Marker动画的每一帧图片，动画的描点和大小以第一帧为准，建议图片大小保持一致。
    
    参数:
    
    icons - Marker动画帧的列表。
    
    从以下版本开始:
    
    2.1.4
  - getIcons
```
public java.util.ArrayList<BitmapDescriptor> getIcons()
```
    返回Marker动画帧的图标列表。
    
    返回:
    
    Marker动画帧的图标列表。
    
    从以下版本开始:
    
    2.1.4
  - remove
```
public void remove()
```
    删除当前marker。在删除当前marker之后，它的所有方法将不被支持。
    
    指定者:
    
    remove 在类中 BasePointOverlay
    
    从以下版本开始:
    
    2.0
  - destroy
```
public void destroy()
```
    删除当前marker并销毁Marker的图片等资源。一旦使用此方法，该对象将被彻底释放。
    
    指定者:
    
    destroy 在类中 BasePointOverlay
    
    从以下版本开始:
    
    2.0.2
  - getId
```
public java.lang.String getId()
```
    返回Marker 的Id，每个marker 的唯一标识，用来区分不同的Marker。
    
    指定者:
    
    getId 在类中 BasePointOverlay
    
    返回:
    
    Marker的Id。
    
    从以下版本开始:
    
    2.0
  - setPerspective
```
public void setPerspective(boolean isPerspective)
```
    已过时。已取消这个效果
    
    设置是否开启 Marker 覆盖物近大远小效果，默认开启用在marker初始化之后。当地图倾斜时，远方的标记变小，附近的标记变大。
    
    参数:
    
    isPerspective - true，设置近大远小效果；false，普通效果。
    
    从以下版本开始:
    
    2.1.0
  - isPerspective
```
public boolean isPerspective()
```
    已过时。已取消这个效果
    
    获取 Marker 覆盖物是否开启近大远小效果。默认为false，不具有此效果。
    
    返回:
    
    Marker 覆盖物是否设置为近大远小效果。true为近大远小效果，反之没有效果。
    
    从以下版本开始:
    
    2.1.0
  - setPosition
```
public void setPosition(LatLng latlng)
```
    设置 Marker 覆盖物的位置坐标。
    若想让标记随地图移动，可以使用此方法改变。若想让 marker 在屏幕固定显示，可以使用 setPositionByPixels(int, int) 方法。
    
    指定者:
    
    setPosition 在类中 BasePointOverlay
    
    参数:
    
    latlng - 位置坐标。
    
    从以下版本开始:
    
    2.0
  - getPosition
```
public LatLng getPosition()
```
    获取 Marker 覆盖物的位置坐标。
    
    指定者:
    
    getPosition 在类中 BasePointOverlay
    
    返回:
    
    Marker 覆盖物的位置坐标。
    
    从以下版本开始:
    
    2.0
  - setTitle
```
public void setTitle(java.lang.String title)
```
    设置Marker 覆盖物的标题。
    
    指定者:
    
    setTitle 在类中 BasePointOverlay
    
    参数:
    
    title - 标题信息。
    
    从以下版本开始:
    
    2.0
  - getTitle
```
public java.lang.String getTitle()
```
    获取Marker 覆盖物的标题。
    
    指定者:
    
    getTitle 在类中 BasePointOverlay
    
    返回:
    
    Marker 覆盖物的标题。
    
    从以下版本开始:
    
    2.0
  - setSnippet
```
public void setSnippet(java.lang.String snippet)
```
    设置Marker 覆盖物的文字片段。
    
    指定者:
    
    setSnippet 在类中 BasePointOverlay
    
    参数:
    
    snippet - 文字片段。
    
    从以下版本开始:
    
    2.0.1
  - getSnippet
```
public java.lang.String getSnippet()
```
    获取Marker 覆盖物的文字片段。
    
    指定者:
    
    getSnippet 在类中 BasePointOverlay
    
    返回:
    
    marker 覆盖物的文字片段。
    
    从以下版本开始:
    
    2.0
  - setIcon
```
public void setIcon(BitmapDescriptor icon)
```
    设置 Marker覆盖物的图标
    
    参数:
    
    icon - 图标
    
    从以下版本开始:
    
    2.0.4
  - setAnchor
```
public void setAnchor(float anchorU,
                      float anchorV)
```
    设置Marker覆盖物的锚点比例。锚点是定位图标接触地图平面的点。图标的左上顶点为（0,0）点，右下点为（1,1）点。默认情况下，锚点为（0.5,1.0）。
    
    参数:
    
    anchorU - 锚点水平范围的比例。
    
    anchorV - 锚点垂直范围的比例。
    
    从以下版本开始:
    
    2.0.4
  - setDraggable
```
public void setDraggable(boolean paramBoolean)
```
    设置Marker覆盖物是否允许拖拽。默认不可拖拽当标记设置为可拖拽，用户可通过长按标记来进行拖拽。
    
    参数:
    
    paramBoolean - Marker是否可拖动，true表示可拖拽，false表示不可拖拽。
    
    从以下版本开始:
    
    2.0.1
  - isDraggable
```
public boolean isDraggable()
```
    获得Marker覆盖物的拖拽状态。
    
    返回:
    
    true 可以拖拽；false 不可以拖拽。
    
    从以下版本开始:
    
    2.0.1
  - showInfoWindow
```
public void showInfoWindow()
```
    显示 Marker 覆盖物的信息窗口。
    
    指定者:
    
    showInfoWindow 在类中 BasePointOverlay
    
    从以下版本开始:
    
    2.0
  - hideInfoWindow
```
public void hideInfoWindow()
```
    隐藏Marker覆盖物的信息窗口。如果Marker本身是不可以见的，此方法将不起任何作用。
    
    从以下版本开始:
    
    2.0
  - isInfoWindowShown
```
public boolean isInfoWindowShown()
```
    返回Marker覆盖物的信息窗口是否显示，true: 显示，false: 不显示。此方法返回值时不会参考这个信息窗口是否在当前屏幕上真的可见。
    
    返回:
    
    Marker 覆盖物的信息窗口是否显示。
    
    从以下版本开始:
    
    2.0
  - setAltitude
```
public void setAltitude(float altitude)
```
    设置marker海拔
    
    参数:
    
    altitude -
    
    从以下版本开始:
    
    9.5.0
  - getAltitude
```
public float getAltitude()
```
    获取marker海拔
    
    返回:
    
    marker海拔
    
    从以下版本开始:
    
    9.5.0
  - setVisible
```
public void setVisible(boolean visible)
```
    设置 Marker 覆盖物的可见属性。如果Marker 的可见属性为false 时，信息窗口也会同时为不可见。
    
    指定者:
    
    setVisible 在类中 BasePointOverlay
    
    参数:
    
    visible - 一个布尔值，表示Marker是否可见，true表示可见，false表示不可见。
    
    从以下版本开始:
    
    2.0
  - isVisible
```
public boolean isVisible()
```
    返回Marker是否可见。
    
    指定者:
    
    isVisible 在类中 BasePointOverlay
    
    返回:
    
    Marker是否可见。true：可见；false：不可见。
    
    从以下版本开始:
    
    2.0
  - equals
```
public boolean equals(java.lang.Object other)
```
    覆盖:
    
    equals 在类中 java.lang.Object
  - hashCode
```
public int hashCode()
```
    覆盖:
    
    hashCode 在类中 java.lang.Object
  - setObject
```
public void setObject(java.lang.Object object)
```
    设置Marker覆盖物的附加信息对象。用户可以自定义Marker的属性。
    
    指定者:
    
    setObject 在类中 BasePointOverlay
    
    参数:
    
    object - Marker覆盖物的附加信息对象
    
    从以下版本开始:
    
    2.0.2
  - getObject
```
public java.lang.Object getObject()
```
    获取Marker覆盖物的附加信息对象，即自定义的Marker的属性。
    
    指定者:
    
    getObject 在类中 BasePointOverlay
    
    返回:
    
    Marker覆盖物的附加信息对象。
    
    从以下版本开始:
    
    2.0.2
  - setRotateAngle
```
public void setRotateAngle(float rotate)
```
    设置Marker覆盖物图片旋转的角度，从正北开始，逆时针计算。
    
    指定者:
    
    setRotateAngle 在类中 BasePointOverlay
    
    参数:
    
    rotate - Marker图片旋转的角度，从正北开始，逆时针计算。
    
    从以下版本开始:
    
    2.1.4
  - getRotateAngle
```
public float getRotateAngle()
```
    获取 Marker覆盖物的图片旋转角度，从正北开始，逆时针计算。
    
    指定者:
    
    getRotateAngle 在类中 BasePointOverlay
    
    返回:
    
    Marker覆盖物的图片旋转角度。
    
    从以下版本开始:
    
    2.3.0
  - setToTop
```
public void setToTop()
```
    设置当前marker在最上面。
    
    从以下版本开始:
    
    2.2.1
  - setFlat
```
public void setFlat(boolean flat)
```
    设置Marker覆盖物是否平贴在地图上。
    
    参数:
    
    flat - Marker平贴地图设置为 true，面对镜头设置为 false。
    
    从以下版本开始:
    
    2.2.1
  - isFlat
```
public boolean isFlat()
```
    返回Marker覆盖物是否是平贴在地图上。
    
    返回:
    
    若marker平贴在地图上返回 true；若marker面对镜头返回 false。
    
    从以下版本开始:
    
    2.2.1
  - setPositionByPixels
```
public void setPositionByPixels(int x,
                                int y)
```
    设置marker覆盖物在屏幕的像素坐标。若用此方式，Marker固定显示在屏幕上；如果想让标记随地图移动，可以使用 setPosition(LatLng) 改变。
    
    参数:
    
    x - 横向像素点。
    
    y - 纵向像素点。
    
    从以下版本开始:
    
    2.3.0
  - setZIndex
```
public void setZIndex(float zIndex)
```
    设置Marker覆盖物的z轴值。
    
    参数:
    
    zIndex - z轴，即竖直方向上的值
    
    从以下版本开始:
    
    2.5.0
  - getZIndex
```
public float getZIndex()
```
    获取Marker覆盖物的z轴值。
    
    返回:
    
    zIndex z轴，即竖直方向上的值
    
    从以下版本开始:
    
    2.5.0
  - setAnimation
```
public void setAnimation(Animation animation)
```
    设置动画,动画包含，旋转，缩放，消失，平移以及它们的组合动画
    
    指定者:
    
    setAnimation 在类中 BasePointOverlay
    
    参数:
    
    animation - 动画类，详情请看 Animation
    
    从以下版本开始:
    
    4.0.0
  - startAnimation
```
public boolean startAnimation()
```
    开始动画
    
    指定者:
    
    startAnimation 在类中 BasePointOverlay
    
    返回:
    
    返回false表示开启动画失败
    
    从以下版本开始:
    
    4.0.0
  - getAlpha
```
public float getAlpha()
```
    获取Marker覆盖物的透明度,透明度范围[0,1] 1为不透明,默认值为1
    
    返回:
    
    透明度
    
    从以下版本开始:
    
    3.3.2
  - setAlpha
```
public void setAlpha(float alpha)
```
    设置Marker覆盖物的透明度
    
    参数:
    
    alpha - 透明度范围[0,1] 1为不透明
    
    从以下版本开始:
    
    3.3.2
  - getOptions
```
public MarkerOptions getOptions()
```
    获取Marker覆盖物的选项类
    
    返回:
    
    获取失败的时候返回null,详见 MarkerOptions
    
    从以下版本开始:
    
    4.0.0
  - isClickable
```
public boolean isClickable()
```
    获取Maker覆盖物的点击状态,可以通过 Marker.setClickable(boolean) 设置是否可以点击
    
    返回:
    
    true : 表示可以点击,false:表示不可点击
    
    从以下版本开始:
    
    4.0.0
  - isInfoWindowEnable
```
public boolean isInfoWindowEnable()
```
    获取Marker覆盖物是否允许InfoWindow显示, 可以通过 Marker.setInfoWindowEnable(boolean) 进行设置
    
    指定者:
    
    isInfoWindowEnable 在类中 BasePointOverlay
    
    返回:
    
    true: 允许显示,false:不允许显示
    
    从以下版本开始:
    
    4.0.0
  - setInfoWindowEnable
```
public void setInfoWindowEnable(boolean enabled)
```
    设置Marker覆盖物的InfoWindow是否允许显示,默认为true
    设置为false之后, 调用Marker.showInfoWindow() 将不会生效
    
    参数:
    
    enabled - true:允许显示,false:不允许显示
    
    从以下版本开始:
    
    4.0.0
  - setMarkerOptions
```
public void setMarkerOptions(MarkerOptions opt)
```
    设置Marker覆盖物的属性选项类通过markerOption 给marker设置属性
    
    参数:
    
    opt - 一个MarkerOptions 对象，它定义了如何渲染Marker 的属性。
    
    从以下版本开始:
    
    4.0.0
  - setClickable
```
public void setClickable(boolean clickable)
```
    设置Marker覆盖物是否可以点击
    
    参数:
    
    clickable - true : 表示可以点击,false:表示不可点击
    
    从以下版本开始:
    
    4.0.0
  - isRemoved
```
public boolean isRemoved()
```
    获取当前Marker是否是被移除状态
    
    返回:
    
    true表示已经被移除，false表示没有
    
    从以下版本开始:
    
    5.2.1

类 Marker

字段概要

从类继承的字段 com.amap.api.maps.model.BaseOverlay

方法概要

从类继承的方法 com.amap.api.maps.model.BasePointOverlay

从类继承的方法 com.amap.api.maps.model.BaseOverlay

从类继承的方法 java.lang.Object

方法详细资料

setPeriod

getPeriod

setIcons

getIcons

remove

destroy

getId

setPerspective

isPerspective

setPosition

getPosition

setTitle

getTitle

setSnippet

getSnippet

setIcon

setAnchor

setDraggable

isDraggable

showInfoWindow

hideInfoWindow

isInfoWindowShown

setAltitude

getAltitude

setVisible

isVisible

equals

hashCode

setObject

getObject

setRotateAngle

getRotateAngle

setToTop

setFlat

isFlat

setPositionByPixels

setZIndex

getZIndex

setAnimation

startAnimation

getAlpha

setAlpha

getOptions

isClickable

isInfoWindowEnable

setInfoWindowEnable

setMarkerOptions

setClickable

isRemoved