com.amap.api.maps2d.model

## 类 GroundOverlay

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

-     public final class GroundOverlay
      extends java.lang.Object

  图片层是一张图片以合适的大小贴在地图上。
  - 位置: 可以通过设置中心点或者图片区域来确定图片层的位置。在添加图片层之前，如果不设置中心点或者图片区域，会报IllegalArgumentException异常。
  - 图片： 给图片层的贴图。在添加图片层之前，如果没有设置图片，会报IllegalArgumentException 异常。
  - 角度： 图片从正北开始，逆时针方向旋转，中心点为锚点。
  - Z轴 ： Z轴是控制地图覆盖物（overlay）之间的绘制层次的参数。这个参数能够控制Circles、Polygons、Polyline的绘制层次，但不会影响marker。Z轴数值越大的覆盖物（overlay）将会绘制在更上层。如果两个及两个以上覆盖物（overlay）的Z轴数值相同，则最后的绘制结果是随机的 。覆盖物（overlay）的默认为Z轴为0。
  - 可见：这个属性表示了线段是否可以显示在地图上。如果设置为不可见，则绘制地图时不会绘制此线段，但其他属性不受影响。默认为可见。

    线段属性的修改必须在主线程里调用，否则将会抛出IllegalStateException。

  从以下版本开始:
    V2.2.0

- - ### 方法概要

    所有方法 实例方法 具体方法
    限定符和类型 | 方法和说明
    --- | ---
    `boolean` | `equals(java.lang.Object object)`
    `float` | `getBearing()` 获取图片层旋转的角度。
    `LatLngBounds` | `getBounds()` 获取图片层位置的矩形区域。
    `float` | `getHeight()` 得到图片层的高。
    `java.lang.String` | `getId()` 得到图片层的ID，一个地图上的每个图片层都有自己的ID。
    `LatLng` | `getPosition()` 锚点在地图上的位置。
    `float` | `getTransparency()` 获取图片层的透明度。
    `float` | `getWidth()` 得到图片层的宽。
    `float` | `getZIndex()` 获取图片层的zIndex。
    `int` | `hashCode()`
    `boolean` | `isVisible()` 得到当前图片层的可见性。
    `void` | `remove()` 从地图中删除此图片层，在图片层删除后，它的所有方法不可用。
    `void` | `setBearing(float bearing)` 设置图片层从正北开始逆时针旋转的角度，中心点为锚点。
    `void` | `setDimensions(float width)` 设置图片层的宽度，图片层的高度根据图片的比例自动变化。
    `void` | `setDimensions(float width, float height)` 设置图片层的宽度和高度，图片会被拉伸，可能不会保留之前的图片比例。
    `void` | `setImage(BitmapDescriptor icon)` 设置图片层的图片，新图片会使用老图片的矩形区域。
    `void` | `setPosition(LatLng latLng)` 设置根据锚点设置图片层的位置，图片层的其他属性不变。
    `void` | `setPositionFromBounds(LatLngBounds latLngBounds)` 根据矩形区域设置图片层的位置。
    `void` | `setTransparency(float transparency)` 设置图片层的透明度。
    `void` | `setVisible(boolean visible)` 设置图片层是否可见。
    `void` | `setZIndex(float zIndex)` 设置图片层的zIndex。

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

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

- - ### 方法详细资料

    - #### remove

          public void remove()

      从地图中删除此图片层，在图片层删除后，它的所有方法不可用。
      从以下版本开始:
        V2.2.0

    - #### getId

          public java.lang.String getId()

      得到图片层的ID，一个地图上的每个图片层都有自己的ID。
      返回:
        当前图片层的ID。
      从以下版本开始:
        V2.2.0

    - #### setPosition

          public void setPosition(LatLng latLng)

      设置根据锚点设置图片层的位置，图片层的其他属性不变。
      参数:
        `latLng` - 可以设置图片层的位置的锚点。
      从以下版本开始:
        V2.2.0

    - #### getPosition

          public LatLng getPosition()

      锚点在地图上的位置。
      返回:
        锚点在地图上的位置。
      从以下版本开始:
        V2.2.0

    - #### setDimensions

          public void setDimensions(float width)

      设置图片层的宽度，图片层的高度根据图片的比例自动变化。
      参数:
        `width` - 图片层的宽度，单位：米。
      从以下版本开始:
        V2.2.0

    - #### setImage

          public void setImage(BitmapDescriptor icon)

      设置图片层的图片，新图片会使用老图片的矩形区域。
      参数:
        `icon` - 新图片。
      从以下版本开始:
        V2.2.0

    - #### setDimensions

          public void setDimensions(float width,
                                    float height)

      设置图片层的宽度和高度，图片会被拉伸，可能不会保留之前的图片比例。
      参数:
        `width` - 图片层的宽度。
        `height` - 图片层的高度。
      从以下版本开始:
        V2.2.0

    - #### getWidth

          public float getWidth()

      得到图片层的宽。
      返回:
        图片层的宽。
      从以下版本开始:
        V2.2.0

    - #### getHeight

          public float getHeight()

      得到图片层的高。
      返回:
        图片层的高。
      从以下版本开始:
        V2.2.0

    - #### setPositionFromBounds

          public void setPositionFromBounds(LatLngBounds latLngBounds)

      根据矩形区域设置图片层的位置。当设置时忽略旋转的角度，但是画此图片层时还是会使用之前的旋转角度。
      参数:
        `latLngBounds` - 可以设置图片层位置的矩形区域。
      从以下版本开始:
        V2.2.0

    - #### getBounds

          public LatLngBounds getBounds()

      获取图片层位置的矩形区域。
      返回:
        图片层位置的矩形区域。
      从以下版本开始:
        V2.2.0

    - #### setBearing

          public void setBearing(float bearing)

      设置图片层从正北开始逆时针旋转的角度，中心点为锚点。
      参数:
        `bearing` - 旋转的角度。
      从以下版本开始:
        V2.2.0

    - #### getBearing

          public float getBearing()

      获取图片层旋转的角度。
      返回:
        旋转的角度。
      从以下版本开始:
        V2.2.0

    - #### setZIndex

          public void setZIndex(float zIndex)

      设置图片层的zIndex。
      参数:
        `zIndex` -
      从以下版本开始:
        V2.2.0

    - #### getZIndex

          public float getZIndex()

      获取图片层的zIndex。
      返回:
        zIndex。
      从以下版本开始:
        V2.2.0

    - #### setVisible

          public void setVisible(boolean visible)

      设置图片层是否可见。
      参数:
        `visible` - 图片层是否可见。
      从以下版本开始:
        V2.2.0

    - #### isVisible

          public boolean isVisible()

      得到当前图片层的可见性。不管是否在屏幕中，只看是否在地图中存在。
      返回:
      从以下版本开始:
        V2.2.0

    - #### setTransparency

          public void setTransparency(float transparency)

      设置图片层的透明度。
      参数:
        `transparency` - 是0到1之间的数，0为不透明，1为全透明。
      从以下版本开始:
        V2.2.0

    - #### getTransparency

          public float getTransparency()

      获取图片层的透明度。
      返回:
        图片层的透明度。
      从以下版本开始:
        V2.2.0

    - #### equals

          public boolean equals(java.lang.Object object)

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

    - #### hashCode

          public int hashCode()

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