mbutil 0.3.0

# MBUtil

MBUtil是一个用于导入和导出[MBTiles](http://mbtiles.org/)格式的工具，
通常由[Mapbox](http://mapbox.com/) [TileMill](http://mapbox.com/tilemill/)创建。

在将瓦片导出到磁盘之前，查看是否有适合您的[Mapbox托管计划](http://mapbox.com/plans/)
或开源的[MBTiles服务器实现](https://github.com/mapbox/mbtiles-spec/wiki/Implementations)
因为磁盘上的瓦片难以管理。

[](http://travis-ci.org/mapbox/mbutil)

## 安装

Git checkout（需要git）

git clone git://github.com/mapbox/mbutil.git
cd mbutil
# 获取用法
./mb-util -h

然后全局安装mb-util命令

sudo python setup.py install
# 然后可以运行
mb-util

Python安装（需要easy_install）

easy_install mbutil
mb-util -h

## 使用

$ mb-util -h
用法：mb-util [选项] 输入 输出

示例

将mbtiles文件导出到文件目录
$ mb-util world.mbtiles tiles # tiles必须已存在

将瓦片目录导入到mbtiles文件
$ mb-util tiles world.mbtiles # mbtiles文件必须已存在

选项
-h, --help 显示此帮助信息并退出
--scheme=SCHEME 瓦片的贴图方案。默认为"xyz"（z/x/y），
其他选项是"tms"，它也是z/x/y
但是使用反转的y坐标，以及“wms”复制
MapServer WMS瓦片缓存目录结构“z/000/000/x/000/000/y.png”
--image_format=FORMAT
图像瓦片的格式，可以是png、jpg、webp或pbf
--grid_callback=CALLBACK
选项以控制UTFGrid瓦片的JSONP回调。如果
网格不作为JSONP使用，您可以
移除指定 --grid_callback="" 的回调
--do_compression 执行mbtiles压缩
--silent 指定操作是否应静默运行


将`mbtiles`文件导出到文件系统上的文件

mb-util World_Light.mbtiles 目录


将目录导入到`mbtiles`文件

mb-util 目录 World_Light.mbtiles

## 要求

* Python `>= 2.6`

## 元数据

MBUtil将元数据作为JSON导入和导出，存储在瓦片目录的根目录中，文件名为`metadata.json`。

```javascript
{
"name": "World Light",
"description": "A Test Metadata",
"version": "3"
}
```

## 测试

此项目使用[nosetests](http://readthedocs.org/docs/nose/en/latest/)进行测试。安装nosetests

pip install nose
或

easy_install nose

然后运行

nosetests

## 参考资料链接

* [node-mbtiles提供mbpipe](https://github.com/mapbox/node-mbtiles/wiki/Post-processing-MBTiles-with-MBPipe)，一个有用的实用工具。
* [mbliberator](https://github.com/calvinmetcalf/mbliberator) 相似的程序，但在node中。

## 许可证

BSD - 查看 LICENSE.md

## 作者

- Tom MacWright (tmcw)
- Dane Springmeyer (springmeyer)
- Mathieu Leplatre (leplatrem)