gdal2tiles(1)						      General Commands Manual						     gdal2tiles(1)

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.

GDAL
								  Tue Sep 18 2012						     gdal2tiles(1)