图块叠加层是显示在基本地图图块之上的一组图像。这些板块 也可以是透明的,以便您向现有地图添加地图项。图块叠加层具有 以下属性:
- 图块提供程序
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。
|
继承的方法摘要
公共方法
<ph type="x-smartling-placeholder"></ph> 公开 无效 clearTileCache ()
清除图块缓存,以便从 TileProvider
再次请求所有图块。
调用该方法后,系统也会从地图中清除该图块叠加层的当前图块
方法。该 API 会在内存中保留一个较小的图块缓存。如果您想缓存
则应该实现磁盘缓存。
<ph type="x-smartling-placeholder"></ph> 公开 布尔值 等于 (其他对象)
<ph type="x-smartling-placeholder"></ph> 公开 布尔值 getFadeIn ()
获取叠加层图块是否应淡入。
返回
- 如果功能块要淡入,则为
true
;如果未使用,则为false
。
<ph type="x-smartling-placeholder"></ph> 公开 字符串 getId ()
获取此图块叠加层的 ID。
<ph type="x-smartling-placeholder"></ph> 公开 浮点数 getTransparency ()
获取此图块叠加层的透明度。
返回
- 此图块叠加层的透明度。
<ph type="x-smartling-placeholder"></ph> 公开 浮点数 getZIndex ()
获取此图块叠加层的 zIndex。
返回
- 图块叠加层的 zIndex。
<ph type="x-smartling-placeholder"></ph> 公开 整数 hashCode ()
<ph type="x-smartling-placeholder"></ph> 公开 布尔值 isVisible ()
获取此图块叠加层的可见性。请注意,这不会返回 叠加层实际上位于屏幕的视口内,但如果是叠加层,那么是否会 包含在屏幕视口中
返回
- 该图块叠加层的可见性。
<ph type="x-smartling-placeholder"></ph> 公开 无效 删除 ()
从地图中删除此图块叠加层。
<ph type="x-smartling-placeholder"></ph> 公开 无效 setFadeIn (布尔值 fadeIn)
设置叠加层图块是否应淡入。
参数
fadeIn | true :使功能块淡入;false ,以便立即呈现它们。
|
---|
<ph type="x-smartling-placeholder"></ph> 公开 无效 setTransparency (浮动透明度)
设置此图块叠加层的透明度。请参阅此类顶部的文档,了解 。
参数
透明度 | [0..1] 范围内的浮点数,其中 0 表示图块
叠加层是不透明的,1 表示图块叠加层是透明的。
|
---|
<ph type="x-smartling-placeholder"></ph> 公开 无效 setVisible (布尔值可见)
设置此图块叠加层的可见性。不显示时,不会绘制图块叠加层, 并保留所有其他属性默认情况下,图块叠加层处于可见状态。
参数
可见 | true ,可使此叠加层可见;false 可将其设为不可见。
|
---|
<ph type="x-smartling-placeholder"></ph> 公开 无效 setZIndex (浮动 zIndex)
设置此图块叠加层的 zIndex。如需了解详情,请参阅此类顶部的文档 信息。
参数
zIndex | 此图块叠加层的 zIndex。 |
---|