<!-- This comment will put IE 6, 7 and 8 in quirks mode -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>gdal2tiles.py</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javaScript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body onload='searchBox.OnSelectItem(0);'>
<!-- Generated by Doxygen 1.6.2-20100208 -->
<script type="text/javascript"><!--
var searchBox = new SearchBox("searchBox", "search",false,'Search');
--></script>
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<img id="MSearchSelect" src="search/search.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</div>
</li>
</ul>
</div>
</div>
<div class="contents">
<h1><a class="anchor" id="gdal2tiles">gdal2tiles.py </a></h1><p>generates directory with TMS tiles, KMLs and simple web viewers</p>
<h2><a class="anchor" id="gdal2tiles_synopsis">
SYNOPSIS</a></h2>
<div class="fragment"><pre class="fragment">
gdal2tiles.py [-title "Title"] [-publishurl http://yourserver/dir/]
[-nogooglemaps] [-noopenlayers] [-nokml]
[-googlemapskey KEY] [-forcekml] [-v]
input_file [output_dir]
</pre></div><h2><a class="anchor" id="gdal2tiles_description">
DESCRIPTION</a></h2>
<p>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.</p>
<p>GDAL2Tiles creates also necessary metadata for Google Earth (KML SuperOverlay), in case the supplied map uses EPSG:4326 projection.</p>
<p>World files and embedded georeference is used during tile generation, but you can publish a picture without proper georeference too.</p>
<dl>
<dt><b>-title</b> <em>"Title"</em>: </dt>
<dd>Title used for generated metadata, web viewers and KML files. </dd>
<dt><b>-publishurl</b> <em><a href="http://yourserver/dir/">http://yourserver/dir/</a></em>: </dt>
<dd>Address of a directory into which you are going to upload the result. It should end with slash. </dd>
<dt><b>-nogooglemaps</b>: </dt>
<dd>Do not generate Google Maps based html page. </dd>
<dt><b>-noopenlayers</b>: </dt>
<dd>Do not generate OpenLayers based html page. </dd>
<dt><b>-nokml</b>: </dt>
<dd>Do not generate KML files for Google Earth. </dd>
<dt><b>-googlemapskey</b> <em>KEY</em>: </dt>
<dd>Key for your domain generated on Google Maps API web page (<a href="http://www.google.com/apis/maps/signup.html">http://www.google.com/apis/maps/signup.html</a>). </dd>
<dt><b>-forcekml</b> </dt>
<dd>Force generating of KML files. Input file must use EPSG:4326 coordinates! </dd>
<dt><b>-v</b> </dt>
<dd>Generate verbose output of tile generation. </dd>
</dl>
<p>NOTE: gdal2tiles.py is a Python script, and will only work if GDAL was built with Python support. </p>
</div>
<!--- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr>
Generated for GDAL by
<a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.6.2-20100208.
</body>
</html>
