gdal2mbtiles 2.1.5

将GDAL可读数据集转换为MBTiles文件

gdal2mbtiles 帮助您生成可以通过浏览器映射库在您的网站上显示的网络映射瓦片。

GDAL可读文件 是地理参考图像，这意味着它们被定位并投影到世界上。为了在网络上显示动态地图，您不想一次性提供整个图像，因此必须将其切割成由瓦片服务器托管的瓦片。

MBTiles文件格式由 MapBox 开发，以简化瓦片存储。您可以将最终文件上传到他们的服务，或运行自己的瓦片服务器。MapBox提供了一个名为 TileStream 的服务。

GDAL的后续版本（>= 2）允许通过 gdal_translate 和 gdaladdo 命令生成mbtiles文件。然而，gdal2mbtiles提供了一些优势

• 允许您指定一个最高分辨率/缩放级别。GDAL始终使用输入栅格的原始分辨率来确定mbtiles输出的最高缩放级别，而gdal2mbtiles还可以上采样以创建比原始文件分辨率更高的缩放级别。

• gdal_translate命令仅转换原始分辨率的geotiff，因此通过概述（gdaladdo）添加较低分辨率到文件中。

• gdaladdo只能添加到与瓦片/块大小（256x256）对应的缩放级别。gdal2mbtiles始终可以创建到缩放级别1的图像。

• 性能：gdal2mbtiles使用pyvips进行图像处理，它是并行且快速的。与GDAL的等效处理相比，gdal2mbtiles通常快2-4倍。例如

  • 分辨率14的文件，13000x11000像素，最小分辨率0，最大分辨率14：使用gdal2mbtiles大约5分钟，使用GDAL命令大约8分钟。

  • 分辨率11的文件，200,000x200,000，仅缩放级别11：使用gdal2mbtiles大约30分钟，使用GDAL（使用GDAL_CACHE_MAX和GDAL_NUM_THREADS选项）大约133分钟

安装

PyPI软件包页面：https://pypi.python.org/pypi/gdal2mbtiles/

使用pip

$ pip install gdal2mbtiles

从源代码

$ git clone https://github.com/ecometrica/gdal2mbtiles.git
$ cd gdal2mbtiles
$ python setup.py install

sudo add-apt-repository ppa:ubuntugis/ppa && sudo apt-get update
sudo apt-get install gdal-bin libgdal-dev

pip install \
  --global-option=build_ext \
  --global-option=--gdal-config=/usr/bin/gdal-config \
  --global-option=--include-dirs=/usr/include/gdal/ \
  GDAL=="$(gdal-config --version)"

$ sudo apt-get install --no-install-recommends libvips libvips-dev

$ sudo apt-get install libtiff5 optipng pngquant

命令行界面

$ gdal2mbtiles --help
usage: gdal2mbtiles [-h] [-v] [--name NAME] [--description DESCRIPTION]
                    [--layer-type {baselayer,overlay}] [--version VERSION]
                    [--format {jpg,png}]
                    [--spatial-reference SPATIAL_REFERENCE]
                    [--resampling {near,bilinear,cubic,cubicspline,lanczos}]
                    [--min-resolution MIN_RESOLUTION]
                    [--max-resolution MAX_RESOLUTION] [--fill-borders]
                    [--no-fill-borders] [--zoom-offset N]
                    [--coloring {gradient,palette,exact}]
                    [--color BAND-VALUE:HTML-COLOR]
                    [--colorize-band COLORIZE-BAND]
                    [--png8 PNG8]
                    [INPUT] [OUTPUT]

Converts a GDAL-readable into an MBTiles file

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         explain what is being done

Positional arguments:
  INPUT                 GDAL-readable file.
  OUTPUT                Output filename. Defaults to INPUT.mbtiles

MBTiles metadata arguments:
  --name NAME           Human-readable name of the tileset. Defaults to INPUT
  --description DESCRIPTION
                        Description of the layer. Defaults to ""
  --layer-type {baselayer,overlay}
                        Type of layer. Defaults to "overlay"
  --version VERSION     Version of the tileset. Defaults to "1.0.0"
  --format {jpg,png}    Tile image format. Defaults to "png"

GDAL warp arguments:
  --spatial-reference SPATIAL_REFERENCE
                        Destination EPSG spatial reference. Defaults to 3857
  --resampling {near,bilinear,cubic,cubicspline,lanczos}
                        Resampling algorithm for warping. Defaults to "near"
                        (nearest-neighbour)

Rendering arguments:
  --min-resolution MIN_RESOLUTION
                        Minimum resolution/zoom level to render and slice.
                        Defaults to None (do not downsample)
  --max-resolution MAX_RESOLUTION
                        Maximum resolution/zoom level to render and slice.
                        Defaults to None (do not upsample)
  --fill-borders        Fill image to whole world with empty tiles. Default.
  --no-fill-borders     Do not add borders to fill image.
  --zoom-offset N       Offset zoom level by N to fit unprojected images to
                        square maps. Defaults to 0.
  --png8                Quantizes 32-bit RGBA to 8-bit RGBA paletted PNGs.
                        value range from 2 to 256. Default to False.

Coloring arguments:
  --coloring {gradient,palette,exact}
                        Coloring algorithm.
  --color BAND-VALUE:HTML-COLOR
                        Examples: --color="0:#ff00ff" --color=255:red
  --colorize-band COLORIZE-BAND
                        Raster band to colorize. Defaults to 1

贡献

鸣谢

Maxime Dupuis 和 Simon Law 编写了这个程序，得到了 Ecometrica 的慷慨支持。

查看 AUTHORS.rst 获取完整的贡献者列表。