com.amap.api.maps2d.model

## 类 Marker

- java.lang.Object
- - com.amap.api.maps2d.model.Marker

-     public final class Marker
      extends java.lang.Object

  Marker 是在地图上的一个点绘制图标。这个图标和屏幕朝向一致，和地图朝向无关。一个marker有如下属性： 锚点：图标摆放在地图上的基准点。默认情况下，锚点是从图片下沿的中间处。 位置：marker是通过经纬度的值来标注在地图上的。 标题：当点击Marker 显示在信息窗口的文字，随时可以更改。 片段：除了标题外其他的文字，随时可以更改。 图标：Marker 显示的图标。如果未设置图标，API 将使用默认的图标，高德为默认图标提供了10 种颜色备选。默认情况下，Marker 是可见的。你们随时更改marker 的可见性。
  从以下版本开始:
    V2.0

- - ### 构造器概要

    构造器
    构造器和说明
    `Marker(MarkerOptions options)`

  - ### 方法概要

    所有方法 实例方法 具体方法
    限定符和类型 | 方法和说明
    --- | ---
    `void` | `destroy()` 删除当前marker并销毁Marker的图片等资源。
    `boolean` | `equals(java.lang.Object other)`
    `java.util.ArrayList<BitmapDescriptor>` | `getIcons()` 获取图片资源
    `java.lang.String` | `getId()` 返回marker 的id，每个marker 的唯一标识，用来区分不同的marker。
    `java.lang.Object` | `getObject()` 返回Marker的附加对象，即自定义的Marker的属性。
    `int` | `getPeriod()` 得到多少帧刷新一次图片资源。
    `LatLng` | `getPosition()` 返回当前marker 的经纬度坐标对象。
    `java.lang.String` | `getSnippet()` 返回当前marker 的文字片段
    `java.lang.String` | `getTitle()` 返回marker 的标题。
    `float` | `getZIndex()` 返回当前线段z轴的值。
    `int` | `hashCode()`
    `void` | `hideInfoWindow()` 隐藏marker的InfoWindow信息窗口。
    `boolean` | `isDraggable()` 获得标记的拖动状态。
    `boolean` | `isInfoWindowShown()` 如果marker的信息窗口显示，返回true，否则返回false。
    `boolean` | `isVisible()` 返回marker是否可见。
    `void` | `remove()` 删除当前marker。
    `void` | `setAnchor(float anchorU, float anchorV)` 设置当前marker的锚点 锚点是定位图标接触地图平面的点。
    `void` | `setDraggable(boolean paramBoolean)` 设置标记是否可拖动。
    `void` | `setIcon(BitmapDescriptor icon)` 设置当前marker的图标
    `void` | `setIcons(java.util.ArrayList<BitmapDescriptor> icons)` 多图片刷新模拟gif动画 icons 设置会使用 icon方法覆盖
    `void` | `setObject(java.lang.Object object)` 设置Marker的附加对象。
    `void` | `setPeriod(int period)` 设置多少帧刷新一次图片资源，Marker动画的间隔时间，值越小动画越快。
    `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` | `setVisible(boolean visible)` 设置marker 的可见属性。
    `void` | `setZIndex(float zIndex)` 设置marker Z轴的值。
    `void` | `showInfoWindow()` 显示当前marker 的信息窗口。

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

      `getClass, notify, notifyAll, toString, wait, wait, wait`

- - ### 构造器详细资料

    - #### Marker

          public Marker(MarkerOptions options)

  - ### 方法详细资料

    - #### setPosition

          public void setPosition(LatLng latlng)

      设置marker 的经纬度位置。
      从以下版本开始:
        V2.0

    - #### getPosition

          public LatLng getPosition()

      返回当前marker 的经纬度坐标对象。
      返回:
        当前marker的经纬度坐标对象。
      从以下版本开始:
        V2.0

    - #### getZIndex

          public float getZIndex()

      返回当前线段z轴的值。
      返回:
        zIndex
      从以下版本开始:
        V2.5.0

    - #### setZIndex

          public void setZIndex(float zIndex)

      设置marker Z轴的值。
      参数:
        `zIndex` - z轴的值
      从以下版本开始:
        V2.5.0

    - #### remove

          public void remove()

      删除当前marker。在删除当前marker 之后，它的所有方法将不被支持。
      从以下版本开始:
        V2.0

    - #### setObject

          public void setObject(java.lang.Object object)

      设置Marker的附加对象。用户可以自定义Marker的属性。
      参数:
        `object` - Marker的附加对象
      从以下版本开始:
        V2.0.2

    - #### getObject

          public java.lang.Object getObject()

      返回Marker的附加对象，即自定义的Marker的属性。
      返回:
        Marker的附加对象
      从以下版本开始:
        V2.0.2

    - #### setPeriod

          public void setPeriod(int period)

      设置多少帧刷新一次图片资源，Marker动画的间隔时间，值越小动画越快。默认为20，最小为1。
      参数:
        `period` - 刷新周期，越小速度越快。默认为20，最小为1。
      从以下版本开始:
        v2.2.1

    - #### getPeriod

          public int getPeriod()

      得到多少帧刷新一次图片资源。默认为20，最小为1。
      返回:
        刷新周期，速度越小速度越快。默认为20，最小为1。
      从以下版本开始:
        v2.2.1

    - #### setIcons

          public void setIcons(java.util.ArrayList<BitmapDescriptor> icons)

      多图片刷新模拟gif动画 icons 设置会使用 icon方法覆盖
      从以下版本开始:
        V2.2.1

    - #### getIcons

          public java.util.ArrayList<BitmapDescriptor> getIcons()

      获取图片资源
      从以下版本开始:
        V2.2.1

    - #### destroy

          public void destroy()

      删除当前marker并销毁Marker的图片等资源。一旦使用此方法，该对象将被彻底释放。
      从以下版本开始:
        V2.0.2

    - #### getId

          public java.lang.String getId()

      返回marker 的id，每个marker 的唯一标识，用来区分不同的marker。
      返回:
        Marker的ID。
      从以下版本开始:
        V2.0

    - #### setTitle

          public void setTitle(java.lang.String title)

      设置marker 的标题。
      参数:
        `title` - 标题信息。
      从以下版本开始:
        V2.0

    - #### getTitle

          public java.lang.String getTitle()

      返回marker 的标题。
      返回:
        marker 的标题。
      从以下版本开始:
        V2.0

    - #### setSnippet

          public void setSnippet(java.lang.String snippet)

      设置marker的文字片段。
      从以下版本开始:
        V2.0.1

    - #### getSnippet

          public java.lang.String getSnippet()

      返回当前marker 的文字片段
      返回:
        当前marker 的文字片段。
      从以下版本开始:
        V2.0

    - #### setIcon

          public void setIcon(BitmapDescriptor icon)

      设置当前marker的图标
      参数:
        `icon` - 设置的marker图标
      从以下版本开始:
        V2.0.4

    - #### setAnchor

          public void setAnchor(float anchorU,
                                float anchorV)

      设置当前marker的锚点 锚点是定位图标接触地图平面的点。图标的左顶点为（0,0）点，右底点为（1,1）点。默认情况下，锚点为（0.5,1.0）。
      参数:
        `anchorU` - 锚点水平范围的比例，是一个0 到1 之间的float型数值。
        `anchorV` - 锚点垂直范围的比例，是一个0 到1 之间的float型数值。
      从以下版本开始:
        V2.0.4

    - #### setDraggable

          public void setDraggable(boolean paramBoolean)

      设置标记是否可拖动。当标记设置为可拖动，用户可通过长按标记来进行移动标记。
      从以下版本开始:
        V2.0.1

    - #### isDraggable

          public boolean isDraggable()

      获得标记的拖动状态。当标记设置为可拖动，用户可通过长按标记来进行移动标记。
      返回:
        true 标记可以拖动；false 标记不可以拖动
      从以下版本开始:
        V2.0.1

    - #### showInfoWindow

          public void showInfoWindow()

      显示当前marker 的信息窗口。
      地图上只能同时显示一个InfoWindow，当有多个Marker时，调用这个方法，其他的marker的infowindow将会隐藏。
      从以下版本开始:
        V2.0

    - #### hideInfoWindow

          public void hideInfoWindow()

      隐藏marker的InfoWindow信息窗口。如果marker本身是不可以见的，此方法将不起任何作用。
      从以下版本开始:
        V2.0

    - #### isInfoWindowShown

          public boolean isInfoWindowShown()

      如果marker的信息窗口显示，返回true，否则返回false。此方法返回值时不会参考这个信息窗口是否在当前屏幕上真的可见。
      返回:
        返回marker 是否可见。
      从以下版本开始:
        V2.0

    - #### setVisible

          public void setVisible(boolean visible)

      设置marker 的可见属性。如果当前marker的信息窗口处于显示状态，设置marker 的可见属性为false 时，信息窗口也会同时为不可见。
      从以下版本开始:
        V2.0

    - #### isVisible

          public boolean isVisible()

      返回marker是否可见。
      返回:
        marker是否可见。true，可见；false，不可见。
      从以下版本开始:
        V2.0

    - #### setRotateAngle

          public void setRotateAngle(float rotate)

      设置marker旋转角度，以锚点旋转。
      参数:
        `rotate` -
      从以下版本开始:
        2.2.1

    - #### equals

          public boolean equals(java.lang.Object other)

      覆盖:
        `equals` 在类中 `java.lang.Object`

    - #### hashCode

          public int hashCode()

      覆盖:
        `hashCode` 在类中 `java.lang.Object`

    - #### setPositionByPixels

          public void setPositionByPixels(int x,
                                          int y)

      设置marker在屏幕的像素坐标。若用此方式，marker固定显示在屏幕上；如果想让标记随地图移动，可以使用 `setPosition(LatLng)` 改变。
      参数:
        `x` - 横向像素点。
        `y` - 纵向像素点。
      从以下版本开始:
        V2.4.0