Skip to content
Generate raster image tiles for use with leaflet.
Python JavaScript Other
Branch: master
Clone or download
Latest commit 0d6f73a Oct 26, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
test update example Oct 26, 2016
.gitignore first version Jan 31, 2015
LICENSE moved rastercoords to its own repo Oct 22, 2016 update example Oct 26, 2016 PythonTidy Oct 21, 2016 PythonTidy Oct 21, 2016
test.png moved rastercoords to its own repo Oct 22, 2016


Generate raster image tiles for use with leaflet.

Example in action.

This is a modified version of which adds support for raster images as plain 2D maps in leafletjs.

It adds the option -l or --leaflet to generate the resulting images with the reference point [0,0] in the upper-left (North-West) corner, opposed to the standard behaviour for TMS tiles using the lower-left (South-East) corner.

Together with the small leafletjs plugin leaflet-rastercoords you'll be able to add markers at the correct position using the (x, y) coordinates of the full-size image.


On Debian style OS:

sudo apt install python-gdal

for others give your search-engine a try...

Basic usage

$ -l -p raster -z 0-5 -w none <image> <tilesdir>

Check test/ for usage.

If the -z option is omitted then the tool considers the min. zoom level otherwise note...

Note: The min zoom level for tile generation must be greater or equal to log2(max(width, height)/tilesize)

Assuming an image with 2000x3000 pixels:

# take the larger dimension -> here height = 3000px
$ echo "l(3000/256)/l(2)" | bc -l
# 3.55 --> min zoomlevel for tile generation is 4
# means: ` -l -p raster -z 0-2 ...`
#                                          \__ is not allowed
# correct usage
$ gdal2tiles -l -p raster -z 0-4 ...

Multicore usage

The same works with multicore support, thanks to gdal2tiles-Ticket-4379.

$ -l -p raster -z 0-5 -w none <image> <tilesdir>

Usage with Leaflet

To use the generated tiles with Leaflet there is a small plugin to correctly set the required projection for raster images. Please refer to the documention at leaflet-rastercoords.


To run the example you'll need to generate the tiles for the large image first.

$ cd test
$ ./
$ open index.html

Then open index.html in a browser.

The sample in test

Or see it here in action.

Contribution and License Agreement

If you contribute code to this project, you are implicitly allowing your code to be distributed under the respective license. You are also implicitly verifying that all code is your original work or correctly attributed with the source of its origin and licence.


Modifications and samples are MIT licensed. (MIT licensed)

  • Copyright (c) 2008, Klokan Petr Pridal
  • Copyright (c) 2010-2013, Even Rouault


You can’t perform that action at this time.