.TH "gdal2tiles" 1 "4 Dec 2008" "GDAL" \" -*- nroff -*-
.ad l
.nh
.SH NAME
gdal2tiles \- gdal2tiles.py 
generates directory with TMS tiles, KMLs and simple web viewers
.SH "SYNOPSIS"
.PP
.PP
.nf

gdal2tiles.py [-title "Title"] [-publishurl http://yourserver/dir/]
              [-nogooglemaps] [-noopenlayers] [-nokml]
              [-googlemapskey KEY] [-forcekml] [-v]
              input_file [output_dir]
.fi
.PP
.SH "DESCRIPTION"
.PP
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.
.PP
GDAL2Tiles creates also necessary metadata for Google Earth (KML SuperOverlay), in case the supplied map uses EPSG:4326 projection.
.PP
World files and embedded georeference is used during tile generation, but you can publish a picture without proper georeference too.
.PP
.IP "\fB\fB-title\fP \fI'Title'\fP: \fP" 1c
Title used for generated metadata, web viewers and KML files. 
.IP "\fB\fB-publishurl\fP \fIhttp://yourserver/dir/\fP: \fP" 1c
Address of a directory into which you are going to upload the result. It should end with slash. 
.IP "\fB\fB-nogooglemaps\fP: \fP" 1c
Do not generate Google Maps based html page. 
.IP "\fB\fB-noopenlayers\fP: \fP" 1c
Do not generate OpenLayers based html page. 
.IP "\fB\fB-nokml\fP: \fP" 1c
Do not generate KML files for Google Earth. 
.IP "\fB\fB-googlemapskey\fP \fIKEY\fP: \fP" 1c
Key for your domain generated on Google Maps API web page (http://www.google.com/apis/maps/signup.html). 
.IP "\fB\fB-forcekml\fP \fP" 1c
Force generating of KML files. Input file must use EPSG:4326 coordinates! 
.IP "\fB\fB-v\fP \fP" 1c
Generate verbose output of tile generation. 
.PP
.PP
NOTE: gdal2tiles.py is a Python script, and will only work if GDAL was built with Python support.
.SH "AUTHORS"
.PP
Klokan Petr Pridal <klokan@klokan.cz> as a Google SoC 2007 Project.