基于 MBTiles 规范扩展的缓存文件格式说明

MBTiles 是由 MapBox 制定的一种将瓦片地图数据存储到SQLite数据库中并可快速使用，管理和分享的规范。该规范由MapBox制定，详见http://mapbox.com/mbtiles-spec/。

SuperMap iServer为了满足自身应用的需求，不仅支持生成和使用满足MBTiles规范的瓦片地图数据，并且基于原规范对MBTiles中的内容进行了扩展。扩展后的.mbtiles文件支持任意坐标系，支持任意分辨率，支持JPG和PNG混合格式的地图瓦片数据。

扩展后的.mbtiles文件仍然使用元数据表”metadata”和瓦片数据表”tiles”来对瓦片地图数据进行管理。

metadata元数据表采用键值对的形式来存储地图瓦片数据的相关设置，包括两个文本类型的字段”name”和”value”,与MBTiles 1.1规范一致。表结构如图1所示：

图1 元数据表的表结构

元数据表的内容举例如表1所示：

表1 元数据表举例

元数据表的各字段（keys）说明如表2所示：

表2 元数据表各字段描述

tiles 瓦片数据表包括所有的瓦片数据和用于定位瓦片数据的一些值。除MBTiles1.1规范的zoom_level, tile_colum, tile_row, tile_data四个字段外，增加了resolution字段，支持任意比例尺、任意分辨率。表结构如图2所示：

图2 瓦片数据表的表结构

瓦片数据的表内容举例如图3：

图3 瓦片数据表的表内容举例

注：当瓦片对应的地面分辨率与表 3 中的地面分辨率无法对应时，zoom_level值为-1。

根据resolution值或对应比例尺读写对应瓦片数据。

表3 MBTiles各显示级别参数列表

tiles瓦片数据表中resolution存储时保留11位有效数字（四舍五入）。有效数字：从近似数的左边第一个不为0的数字起，到精确到的数为止，所有的数字叫这个近似数的有效数字（0.00123的有效数字是1，2，3，有效位数是3）。示例如表4所示：

表4 resolution近似值计算示例

Java中计算resolution的参考代码如下：

public static String getResolutionString(double resolution) {

int n = (int) Math.log10(resolution);

int precision = 11;

if (resolution < 1.0) {

n--;

}

int scale = precision - 1 - n;

return new BigDecimal(resolution).setScale(scale, BigDecimal.ROUND_HALF_UP).toString();

}