NAME¶
gdal2tiles - gdal2tiles.py generates directory with TMS tiles, KMLs and simple
web viewers
SYNOPSIS¶
gdal2tiles.py [-title "Title"] [-publishurl http://yourserver/dir/]
[-nogooglemaps] [-noopenlayers] [-nokml]
[-googlemapskey KEY] [-forcekml] [-v]
input_file [output_dir]
DESCRIPTION¶
This utility generates a directory with small tiles and metadata, following
OSGeo Tile Map Service Specification. Simple web pages with viewers based on
Google Maps and OpenLayers are generated as well - so anybody can comfortably
explore your maps on-line and you do not need to install or configure any
special software (like mapserver) and the map displays very fast in the
webbrowser. You only need to upload generated directory into a web server.
GDAL2Tiles creates also necessary metadata for Google Earth (KML SuperOverlay),
in case the supplied map uses EPSG:4326 projection.
World files and embedded georeference is used during tile generation, but you
can publish a picture without proper georeference too.
- -p PROFILE,
--profile=PROFILE:
- Tile cutting profile (mercator,geodetic,raster) - default
'mercator' (Google Maps compatible).
- -r RESAMPLING,
--resampling= RESAMPLING:
- Resampling method
(average,near,bilinear,cubic,cubicspline,lanczos,antialias) - default
'average'.
- -s SRS,
--s_srs=SRS :
- The spatial reference system used for the source input
data.
- -z ZOOM,
--zoom=ZOOM :
- Zoom levels to render (format:'2-5' or '10').
- -e, --resume:
- Resume mode. Generate only missing files.
- -a NODATA,
--srcnodata=NODATA:
- NODATA transparency value to assign to the input data.
- -v, --verbose
- Generate verbose output of tile generation.
- -h, --help
- Show help message and exit.
- --version
- Show program's version number and exit.
KML (Google Earth) options:
Options for generated Google Earth SuperOverlay metadata
- -k, --force-kml
- Generate KML for Google Earth - default for 'geodetic'
profile and 'raster' in EPSG:4326. For a dataset with different projection
use with caution!
- -n, --no-kml:
- Avoid automatic generation of KML files for EPSG:4326.
- -u URL,
--url=URL:
- URL address where the generated tiles are going to be
published.
Web viewer options:
Options for generated HTML viewers a la Google Maps
- -w WEBVIEWER,
--webviewer= WEBVIEWER:
- Web viewer to generate (all,google,openlayers,none) -
default 'all'.
- -t TITLE,
--title=TITLE :
- Title of the map.
- -c COPYRIGHT,
--copyright= COPYRIGHT:
- Copyright for the map.
- -g GOOGLEKEY,
--googlekey= GOOGLEKEY:
- Google Maps API key from
http://code.google.com/apis/maps/signup.html.
- -y YAHOOKEY,
--yahookey=YAHOOKEY:
- Yahoo Application ID from
http://developer.yahoo.com/wsregapp/.
NOTE: gdal2tiles.py is a Python script that needs to be run against 'new
generation' Python GDAL binding.
AUTHORS¶
Klokan Petr Pridal klokan@klokan.cz as a Google SoC 2007 Project.