TileOverlay

公共最终类 TileOverlay 扩展对象

图块叠加层是显示在基本地图图块之上的一组图像。这些板块 也可以是透明的，以便您向现有地图添加地图项。图块叠加层具有 以下属性：

图块提供程序
TileProvider 提供图块叠加层中使用的图片。您必须 在将图块添加到地图之前，指定图块提供程序。图块提供程序不能 一旦添加即会更改不过，您可以修改功能块提供程序的行为 即可针对特定坐标返回不同的图片。如果图块提供的图块 提供程序发生更改后，必须在之后调用 clearTileCache()，以确保 之前的图块将不再渲染。
Z-index
此图块叠加层相对于其他叠加层（包括 GroundOverlay、Circle、Polyline 和 Polygon，但不是 Marker）。Z-index 较大的叠加层绘制在具有较小 Z-index 的叠加层之上 Z 索引。Z-index 相同的叠加层可按任意顺序绘制。默认的 zIndex 为 0.
透明度
[0..1] 范围内的图块叠加层的透明度，其中 0 表示 叠加层是不透明的，1 表示叠加层是完全透明的。如果指定的 位图已处于半透明状态，那么每个像素的透明度都会经过调整 （例如，如果位图中某个像素的 alpha 值为 200， 将图块叠加层的透明度指定为 0.25，则像素将渲染 alpha 值为 150 的屏幕）。此属性的规范是可选的， 默认的透明度为 0（不透明）。
可见性
用于指明图块叠加层是可见还是不可见，即它是否绘制在 地图。不可见的图块叠加层不会绘制，但会保留其所有其他属性。通过 默认值为 true，即 visible。

您只能在主线程上调用此类中的方法。否则会导致 IllegalStateException。

图块坐标

请注意，世界是使用墨卡托投影（请参阅维基百科）左（西）投影进行投影的 与经度 -180 度以及右侧（东）侧对应的地图 对应于 180 度经度。要使地图为正方形， 地图对应于 85.0511 度的纬度，而地图的底部（南）侧则对应于 85.0511 度的纬度。 纬度为-85.0511 度纬度范围之外的区域将不会渲染。

在每个缩放级别，地图均分为多个图块，且只有图块与屏幕重叠 下载并呈现每个图块都是方形的，并且地图按如下方式分成了多个图块：

  • 缩放级别为 0 时，一个图块代表整个世界。该图块的坐标为 (x, y) = (0, 0)。
  • 缩放级别为 1 时，世界分成 4 个图块，图块以 2 x 2 网格的形式排列。
  • ...
  • 缩放级别为 N 时，世界分成了 4N 个图块，以 2N 的形式进行排列。 x 2N 网格。
请注意，相机支持的最小缩放级别（具体取决于各种因素） 为GoogleMap.getMinZoomLevel和 最大缩放级别为GoogleMap.getMaxZoomLevel。

图块的坐标从地图的左上角（西北）角开始测量。在 缩放级别 N，图块坐标的 x 值范围为 0 到 2N-1， 从西向东增加，y 值介于 0 到 2N - 1 之间 由北向南增加。

示例

GoogleMap map; // ... get a map.
 TileProvider tileProvider; // ... create a tile provider.
 TileOverlay tileOverlay = map.addTileOverlay(
     new TileOverlayOptions().tileProvider(tileProvider));

公共方法摘要

void
clearTileCache()
清除图块缓存，以便从 TileProvider 再次请求所有图块。
boolean
equals（其他对象）
测试此 TileOverlay 是否等于另一个值。
boolean
getFadeIn()
获取叠加层图块是否应淡入。
字符串
getId()
获取此图块叠加层的 ID。
float
getTransparency()
获取此图块叠加层的透明度。
float
getZIndex()
获取此图块叠加层的 zIndex。
int
hashCode()
boolean
isVisible()
获取此图块叠加层的可见性。
void
remove()
从地图中删除此图块叠加层。
void
setFadeIn(boolean fadeIn)
设置叠加层图块是否应淡入。
void
setTransparency（浮动透明度）
设置此图块叠加层的透明度。
void
setVisible(boolean visible)
设置此图块叠加层的可见性。
void
setZIndexsetZIndex(float zIndex)
设置此图块叠加层的 zIndex。

继承的方法摘要

公共方法

公开 无效 clearTileCache ()

清除图块缓存，以便从 TileProvider 再次请求所有图块。 调用该方法后，系统也会从地图中清除该图块叠加层的当前图块 方法。该 API 会在内存中保留一个较小的图块缓存。如果您想缓存 则应该实现磁盘缓存。

公开 布尔值 等于 （其他对象）

测试此 TileOverlay 是否等于另一个值。

参数
其他 Object。
返回
  • 如果两个对象是同一对象（即 == other），则为 true。

公开 布尔值 getFadeIn ()

获取叠加层图块是否应淡入。

返回
  • 如果功能块要淡入，则为 true；如果未使用，则为 false。

公开 字符串 getId ()

获取此图块叠加层的 ID。

公开 浮点数 getTransparency ()

获取此图块叠加层的透明度。

返回
  • 此图块叠加层的透明度。

公开 浮点数 getZIndex ()

获取此图块叠加层的 zIndex。

返回
  • 图块叠加层的 zIndex。

公开 整数 hashCode ()

公开 布尔值 isVisible ()

获取此图块叠加层的可见性。请注意，这不会返回 叠加层实际上位于屏幕的视口内，但如果是叠加层，那么是否会 包含在屏幕视口中

返回
  • 该图块叠加层的可见性。

公开 无效 删除 ()

从地图中删除此图块叠加层。

公开 无效 setFadeIn (布尔值 fadeIn)

设置叠加层图块是否应淡入。

参数
fadeIn true：使功能块淡入；false，以便立即呈现它们。

公开 无效 setTransparency （浮动透明度）

设置此图块叠加层的透明度。请参阅此类顶部的文档，了解 。

参数
透明度 [0..1] 范围内的浮点数，其中 0 表示图块 叠加层是不透明的，1 表示图块叠加层是透明的。

公开 无效 setVisible （布尔值可见）

设置此图块叠加层的可见性。不显示时，不会绘制图块叠加层， 并保留所有其他属性默认情况下，图块叠加层处于可见状态。

参数
可见 true，可使此叠加层可见；false 可将其设为不可见。

公开 无效 setZIndex （浮动 zIndex）

设置此图块叠加层的 zIndex。如需了解详情，请参阅此类顶部的文档 信息。

参数
zIndex 此图块叠加层的 zIndex。