我想使用TileProvider
最新的 Android Maps API (v2) 的新功能在GoogleMap
. 但是,由于我的用户很多时候不会上网,我想将磁贴存储在设备上的 zipfile/文件夹结构中。我将使用Maptiler
with生成我的图块geotiffs
。我的问题是:
- 在设备上存储图块的最佳方式是什么?
- 我将如何创建一个返回本地图块的 TileProvider?
我想使用TileProvider
最新的 Android Maps API (v2) 的新功能在GoogleMap
. 但是,由于我的用户很多时候不会上网,我想将磁贴存储在设备上的 zipfile/文件夹结构中。我将使用Maptiler
with生成我的图块geotiffs
。我的问题是:
您可以将图块放入资产文件夹(如果应用程序大小可以接受)或在第一次启动时将它们全部下载并放入设备存储(SD 卡)。
您可以像这样实现 TileProvider:
public class CustomMapTileProvider implements TileProvider {
private static final int TILE_WIDTH = 256;
private static final int TILE_HEIGHT = 256;
private static final int BUFFER_SIZE = 16 * 1024;
private AssetManager mAssets;
public CustomMapTileProvider(AssetManager assets) {
mAssets = assets;
}
@Override
public Tile getTile(int x, int y, int zoom) {
byte[] image = readTileImage(x, y, zoom);
return image == null ? null : new Tile(TILE_WIDTH, TILE_HEIGHT, image);
}
private byte[] readTileImage(int x, int y, int zoom) {
InputStream in = null;
ByteArrayOutputStream buffer = null;
try {
in = mAssets.open(getTileFilename(x, y, zoom));
buffer = new ByteArrayOutputStream();
int nRead;
byte[] data = new byte[BUFFER_SIZE];
while ((nRead = in.read(data, 0, BUFFER_SIZE)) != -1) {
buffer.write(data, 0, nRead);
}
buffer.flush();
return buffer.toByteArray();
} catch (IOException e) {
e.printStackTrace();
return null;
} catch (OutOfMemoryError e) {
e.printStackTrace();
return null;
} finally {
if (in != null) try { in.close(); } catch (Exception ignored) {}
if (buffer != null) try { buffer.close(); } catch (Exception ignored) {}
}
}
private String getTileFilename(int x, int y, int zoom) {
return "map/" + zoom + '/' + x + '/' + y + ".png";
}
}
现在您可以将它与您的 GoogleMap 实例一起使用:
private void setUpMap() {
mMap.setMapType(GoogleMap.MAP_TYPE_NONE);
mMap.addTileOverlay(new TileOverlayOptions().tileProvider(new CustomMapTileProvider(getResources().getAssets())));
CameraUpdate upd = CameraUpdateFactory.newLatLngZoom(new LatLng(LAT, LON), ZOOM);
mMap.moveCamera(upd);
}
在我的情况下,我也遇到了 MapTiler 生成的瓦片的 y 坐标问题,但我通过将此方法添加到 CustomMapTileProvider 中来管理它:
/**
* Fixing tile's y index (reversing order)
*/
private int fixYCoordinate(int y, int zoom) {
int size = 1 << zoom; // size = 2^zoom
return size - 1 - y;
}
并从 getTile() 方法调用它,如下所示:
@Override
public Tile getTile(int x, int y, int zoom) {
y = fixYCoordinate(y, zoom);
...
}
[更新]
如果您知道自定义地图的精确区域,则应该从方法中返回NO_TILE
缺少的图块。getTile(...)
我是这样做的:
private static final SparseArray<Rect> TILE_ZOOMS = new SparseArray<Rect>() {{
put(8, new Rect(135, 180, 135, 181 ));
put(9, new Rect(270, 361, 271, 363 ));
put(10, new Rect(541, 723, 543, 726 ));
put(11, new Rect(1082, 1447, 1086, 1452));
put(12, new Rect(2165, 2894, 2172, 2905));
put(13, new Rect(4330, 5789, 4345, 5810));
put(14, new Rect(8661, 11578, 8691, 11621));
}};
@Override
public Tile getTile(int x, int y, int zoom) {
y = fixYCoordinate(y, zoom);
if (hasTile(x, y, zoom)) {
byte[] image = readTileImage(x, y, zoom);
return image == null ? null : new Tile(TILE_WIDTH, TILE_HEIGHT, image);
} else {
return NO_TILE;
}
}
private boolean hasTile(int x, int y, int zoom) {
Rect b = TILE_ZOOMS.get(zoom);
return b == null ? false : (b.left <= x && x <= b.right && b.top <= y && y <= b.bottom);
}
在新 API (v2) 中添加自定义 tileproviders 的可能性很大,但是您提到您的用户大多处于离线状态。如果用户在首次启动应用程序时处于脱机状态,您将无法使用新 API,因为它要求用户处于联机状态(似乎至少要建立一次缓存)——否则它只会显示黑屏。
编辑 2/22-14:我最近再次遇到了同样的问题 - 为必须离线工作的应用程序设置自定义磁贴。通过将不可见的(w/h 0/0)地图视图添加到客户端必须下载一些内容的初始视图来解决它。这似乎可行,并允许我稍后在离线模式下使用地图视图。
这就是我在 Kotlin 中实现它的方式:
class LocalTileProvider : TileProvider
{
override fun getTile(x: Int, y: Int, zoom: Int): Tile?
{
// This is for my case only
if (zoom > 11)
return TileProvider.NO_TILE
val path = "${getImagesFolder()}/tiles/$zoom/$x/$y/filled.png"
val file = File(path)
if (!file.exists())
return TileProvider.NO_TILE
return try {
Tile(TILE_SIZE, TILE_SIZE, file.readBytes())
}
catch (e: Exception)
{
TileProvider.NO_TILE
}
}
companion object {
const val TILE_SIZE = 512
}
}