gdal2tiles.py

使用TMS tiles、KMLs和简单的web查看器生成目录。

简介

gdal2tiles.py [-p profile] [-r resampling] [-s srs] [-z zoom]
              [-e] [-a nodata] [-v] [-q] [-h] [-k] [-n] [-u url]
              [-w webviewer] [-t title] [-c copyright]
              [--processes=NB_PROCESSES] [--mpi] [--xyz]
              --tilesize=PIXELS
              [-g googlekey] [-b bingkey] input_file [output_dir] [COMMON_OPTIONS]

描述

此实用程序根据OSGeo Tile映射服务规范生成包含小平铺和元数据的目录。基于Google地图、OpenLayers和传单的简单网页也会生成，这样任何人都可以轻松地在线浏览你的地图，你不需要安装或配置任何特殊软件（如MapServer），地图在web浏览器中显示得非常快。您只需要将生成的目录上载到web服务器上。

GDAL2Tiles还为Google Earth（KML SuperOverlay）创建必要的元数据，以防提供的地图使用EPSG:4326投影。

在生成平铺时使用世界文件和嵌入的地理参考，但也可以在没有正确地理参考的情况下发布图片。

备注

具有非字节数据类型的输入（即。 Int16 ， UInt16 ，…）将被夹在 Byte 数据类型，导致错误的结果。为了避免这种情况，有必要将输入重新缩放到 Byte 数据类型使用 gdal_translate 实用工具。

备注

输入驱动程序的配置选项可能会影响gdal2tiles的输出。一个示例驱动程序配置选项是GDALu PDFu DPI，可以在配置选项

-p <PROFILE>, --profile=<PROFILE>

瓷砖切割轮廓（墨卡托，大地测量，栅格）-默认“墨卡托”（谷歌地图兼容）。

从gdal3.2开始，tms提供了更多的配置文件_XXXX.json文件放置在GDAL数据目录中的文件（前提是所有缩放级别使用相同的原点、平铺尺寸和连续缩放级别之间的分辨率相差两倍）。

-r <RESAMPLING>, --resampling=<RESAMPLING>: 重采样方法（平均、近、双线性、立方、立方线、lanczos、反别名、模式、最大、最小、中等、q1、q3）-默认为“平均”。

-s <SRS>, --s_srs=<SRS>: 用于源输入数据的空间参考系。

--xyz: 生成XYZ平铺（OSM滑动贴图标准）而不是TMS。在默认模式（TMS）中，y=0处的瓷砖是最南端的瓷砖，而在XYZ模式（OGC WMTS也使用）中，y=0处的瓷砖是最北端的瓷砖。

3.1 新版功能.

-z <ZOOM>, --zoom=<ZOOM>: Zoom levels to render (format:'2-5', '10-' or '10').

-e, --resume: 恢复模式。只生成丢失的文件。

-a <NODATA>, --srcnodata=<NODATA>: 输入数据集中的值被认为是透明的。如果输入数据集已经有一个关联的nodata值，它将被指定的值覆盖。

-v, --verbose: 生成磁贴生成的详细输出。

-x, --exclude: Exclude transparent tiles from result tileset.

-q, --quiet: 禁用stdout的消息和状态

2.1 新版功能.

--processes=<NB_PROCESSES>: 用于平铺的并行进程数，以加快计算速度。

2.3 新版功能.

--mpi: Assume launched by mpiexec, enable MPI parallelism and ignore --processes. Requires working MPI environment and the MPI for Python (mpi4py) package. User should set GDAL_CACHEMAX to an appropriate cache size per process based on memory per node and the number of processes launched per node.

3.5 新版功能.

--tilesize=<PIXELS>: 以像素表示的瓷砖宽度和高度。默认值为256。

3.1 新版功能.

-h, --help: 显示帮助消息并退出。

--version: 显示程序的版本号并退出。

KML（谷歌地球）选项

生成Google Earth SuperOverlay元数据的选项

-k, --force-kml: 为Google Earth生成KML-默认为EPSG:4326中的“大地”剖面和“栅格”。对于具有不同投影的数据集，请谨慎使用！

-n, --no-kml: 避免为EPSG:4326自动生成KML文件。

-u <URL>, --url=<URL>: 将要发布生成的磁贴的URL地址。

Web查看器选项

生成HTML查看器的选项a la Google Maps

-w <WEBVIEWER>, --webviewer=<WEBVIEWER>: 要生成的Web查看器（all、google、openlayers、sliple、mapml、none）-默认为“all”。

-t <TITLE>, --title=<TITLE>: 地图的标题。

-c <COPYRIGHT>, --copyright=<COPYRIGHT>: 地图版权所有。

-g <GOOGLEKEY>, --googlekey=<GOOGLEKEY>: Google Maps API key来自http://code.Google.com/API/Maps/signup.html。

-b <BINGKEY>, --bingkey=<BINGKEY>: Bing Maps API密钥来自https://www.bingmapsportal.com/

备注

py是一个需要针对Python GDAL绑定运行的Python脚本。

MapML选项

MapML支持是gdal3.2的新功能。当指定--webviewer=mapml时，将暗示-xyz，如果--profile=geodetic，则暗示--tmsmcompatible。

支持以下配置文件：

墨卡托：映射到OSMTILE MapML平铺方案
大地测量：映射到WGS84 MapML平铺方案
APSTILE：从tmsu MapML_APSTILE.json文件数据文件

输出目录中生成的MapML文件是 mapml.mapl

可用选项包括：

--mapml-template=<filename>: 将替换变量的模板mapml文件的文件名。如果未指定，则使用通用模板_瓷砖.mapml将使用GDAL数据资源中的文件

The --url option is also used to substitute ${URL} in the template MapML file.

实例

基本示例：

gdal2tiles.py --zoom=2-5 input.tif output_folder

MapML生成：

gdal2tiles.py --zoom=16-18 -w mapml -p APSTILE --url "https://example.com" input.tif output_folder

MPI example:

mpiexec -n $NB_PROCESSES gdal2tiles.py --mpi --config GDAL_CACHEMAX 500 --zoom=2-5 input.tif output_folder