1GDAL2TILES(1) GDAL GDAL2TILES(1)
2
3
4
6 gdal2tiles - Generates directory with TMS tiles, KMLs and simple web
7 viewers.
8
10 gdal2tiles.py [-p profile] [-r resampling] [-s srs] [-z zoom]
11 [-e] [-a nodata] [-v] [-q] [-h] [-k] [-n] [-u url]
12 [-w webviewer] [-t title] [-c copyright]
13 [--processes=NB_PROCESSES] [--xyz]
14 --tilesize=TILESIZE
15 [-g googlekey] [-b bingkey] input_file [output_dir]
16
18 This utility generates a directory with small tiles and metadata, fol‐
19 lowing the OSGeo Tile Map Service Specification. Simple web pages with
20 viewers based on Google Maps, OpenLayers and Leaflet are generated as
21 well - so anybody can comfortably explore your maps on-line and you do
22 not need to install or configure any special software (like MapServer)
23 and the map displays very fast in the web browser. You only need to
24 upload the generated directory onto a web server.
25
26 GDAL2Tiles also creates the necessary metadata for Google Earth (KML
27 SuperOverlay), in case the supplied map uses EPSG:4326 projection.
28
29 World files and embedded georeferencing is used during tile generation,
30 but you can publish a picture without proper georeferencing too.
31
32 NOTE:
33 Inputs with non-Byte data type (i.e. Int16, UInt16,...) will be
34 clamped to the Byte data type, causing wrong results. To awoid this
35 it is necessary to rescale input to the Byte data type using
36 gdal_translate utility.
37
38 -p <PROFILE>, --profile=<PROFILE>
39 Tile cutting profile (mercator, geodetic, raster) - default
40 'mercator' (Google Maps compatible).
41
42 -r <RESAMPLING>, --resampling=<RESAMPLING>
43 Resampling method (average, near, bilinear, cubic, cubicspline,
44 lanczos, antialias, mode, max, min, med, q1, q3) - default
45 'average'.
46
47 -s <SRS>, --s_srs=<SRS>
48 The spatial reference system used for the source input data.
49
50 --xyz Generate XYZ tiles (OSM Slippy Map standard) instead of TMS. In
51 the default mode (TMS), tiles at y=0 are the southern-most
52 tiles, whereas in XYZ mode (used by OGC WMTS too), tiles at y=0
53 are the northern-most tiles.
54
55 New in version 3.1.
56
57
58 -z <ZOOM>, --zoom=<ZOOM>
59 Zoom levels to render (format:'2-5' or '10').
60
61 -e, --resume
62 Resume mode. Generate only missing files.
63
64 -a <NODATA>, --srcnodata=<NODATA>
65 NODATA transparency value to assign to the input data.
66
67 -v, --verbose
68 Generate verbose output of tile generation.
69
70 -q, --quiet
71 Disable messages and status to stdout
72
73 New in version 2.1.
74
75
76 --processes=<NB_PROCESSES>
77 Number of processes to use for tiling.
78
79 New in version 2.3.
80
81
82 --tilesize=<TILESIZE>
83 Pixel size of the tiles.
84
85 New in version 3.1.
86
87
88 -h, --help
89 Show help message and exit.
90
91 --version
92 Show program's version number and exit.
93
94 KML (Google Earth) options
95 Options for generated Google Earth SuperOverlay metadata
96
97 -k, --force-kml
98 Generate KML for Google Earth - default for 'geodetic' profile
99 and 'raster' in EPSG:4326. For a dataset with different projec‐
100 tion use with caution!
101
102 -n, --no-kml
103 Avoid automatic generation of KML files for EPSG:4326.
104
105 -u <URL>, --url=<URL>
106 URL address where the generated tiles are going to be published.
107
108 Web viewer options
109 Options for generated HTML viewers a la Google Maps
110
111 -w <WEBVIEWER>, --webviewer=<WEBVIEWER>
112 Web viewer to generate (all, google, openlayers, leaflet, none)
113 - default 'all'.
114
115 -t <TITLE>, --title=<TITLE>
116 Title of the map.
117
118 -c <COPYRIGHT>, --copyright=<COPYRIGHT>
119 Copyright for the map.
120
121 -g <GOOGLEKEY>, --googlekey=<GOOGLEKEY>
122 Google Maps API key from
123 http://code.google.com/apis/maps/signup.html.
124
125 -b <BINGKEY>, --bingkey=<BINGKEY>
126 Bing Maps API key from https://www.bingmapsportal.com/
127
128 NOTE:
129 gdal2tiles.py is a Python script that needs to be run against Python
130 GDAL binding.
131
133 Basic example:
134
135 gdal2tiles.py --zoom=2-5 input.tif output_folder
136
138 Klokan Petr Pridal <klokan@klokan.cz>
139
141 1998-2021
142
143
144
145
146 Jan 05, 2021 GDAL2TILES(1)