GroundOverlay

地面叠加层是固定在地图上的图像。地面叠加层具有以下特征 属性：

职位

您可以通过以下两种方式指定地面叠加层的位置：

• 使用位置：您必须提供地面叠加层的图片，即 LatLng 以及叠加层的宽度（以米为单位）。通过 默认情况下，锚点距离图片顶部 50%，距离图片左侧 50% 图片。此设置可以更改。您可以选择性地提供叠加层的高度（在 米）。如果您没有提供叠加层的高度， 以保持图片的比例
• 使用边界：您必须提供包含图片的 LatLngBounds。

在将地面叠加层添加到地图之前，您必须先为其指定位置， 否则，当地面叠加层IllegalArgumentException 已添加到地图中。此外，您只能使用 GroundOverlayOptions 对象中的方法；否则，在使用第二个方法指定时将会抛出 IllegalStateException。

图片

要用于此叠加层的图片（作为 BitmapDescriptor）。图片将 缩放以适应提供的位置。必须先指定图片，然后才能添加地面 叠加到地图上；否则，系统将抛出 IllegalArgumentException 已添加到地图中。

方向角

图片应顺时针方向旋转的幅度。该城市的中心 旋转角度将是图片的锚点。这是一个可选值，默认方位为 0，即 将图像对齐，使上北下南。

zIndex

此地面叠加层相对于其他叠加层（包括 Polyline 和 TileOverlay，而不是 Marker）。带有 较大的 zIndex 绘制在具有较小 zIndex 的叠加层之上。带有 zIndex 值是任意的。这是可选操作，默认的 zIndex 为 0。

透明度

[0..1] 范围内的地面叠加层的透明度，其中 0 表示 叠加层是不透明的，1 表示叠加层是完全透明的。如果指定的 位图已处于半透明状态，那么每个像素的透明度都会经过调整 （例如，如果位图中某个像素的 alpha 值为 200， 将地面叠加层的透明度指定为 0.25，那么该像素将在 alpha 值为 150 的屏幕）。此属性的规范是可选的， 默认的透明度为 0（不透明）。

可见性

用于指示地面叠加层是可见还是不可见，即它是否绘制在 地图。不可见的地面叠加层不会绘制，但会保留其所有其他属性。 此字段是可选的，默认的可见性为 true，即可见。

可点击性

如果您想要处理用户点击地面叠加层时触发的事件，请将此属性设为 属性设置为 true。您可以随时更改此值。默认值为 false。如果此属性设置为 true，您的应用将会收到发送到 GoogleMap.OnGroundOverlayClickListener 已注册至 setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)。

标记

与地面叠加层关联的 Object。例如，Object 可以 包含有关地面叠加层所表示内容的数据。这比将 单独的 Map<GroundOverlay, Object>。再举一例，您可以关联与数据集中的 ID 对应的 String ID。Google Maps SDK for Android 读取或写入此属性。

此类中的方法必须在 Android 界面线程上调用。否则，系统会在运行时抛出 IllegalStateException。

示例

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));