gdal2tiles 0.1.9

A python library for generating map tiles based on gdal2tiles.py script.

gdal2tiles

A python library for generating map tiles inspired by gdal2tiles.py from GDAL project.

Dependancies

• GDAL development header files, sometimes available as libgdal-dev or libgdal-devel packages.

Installation

To install gdal2tiles library you can use pip:

$ pip install gdal2tiles

Basic usage

import gdal2tiles

gdal2tiles.generate_tiles('/path/to/input_file', '/path/to/output_dir/')

You can also pass various keyword as optional keyword arguments to generate_tiles() function. For example

gdal2tiles.generate_tiles('input_file', 'output_dir/', nb_processes=2, zoom='7-9')

OR

options = {'zoom': (7, 9), 'resume': True}
gdal2tiles.generate_tiles('input_file', 'output_dir/', **options)

In general

gdal2tiles.generate_tiles(input_file, output_folder, **options)

Arguments:

input_file (str): Path to input file.

output_folder (str): Path to output folder.

options: Tile generation options.

Options:

profile (str): Tile cutting profile (mercator,geodetic,raster) - default

‘mercator’ (Google Maps compatible)

resampling (str): Resampling method (average,near,bilinear,cubic,cubicsp

line,lanczos,antialias) - default ‘average’

s_srs: The spatial reference system used for the source input data

zoom: Zoom levels to render; format: ‘[int min, int max]’,

‘min-max’ or ‘int/str zoomlevel’.

tile_size (int): Size of tiles to render - default 256

resume (bool): Resume mode. Generate only missing files.

srcnodata: NODATA transparency value to assign to the input data

tmscompatible (bool): When using the geodetic profile, specifies the base

resolution as 0.703125 or 2 tiles at zoom level 0.

verbose (bool): Print status messages to stdout

kml (bool): Generate KML for Google Earth - default for ‘geodetic’

profile and ‘raster’ in EPSG:4326. For a dataset with different projection use with caution!

url (str): URL address where the generated tiles are going to be published

webviewer (str): Web viewer to generate (all,google,openlayers,none) -

default ‘all’

title (str): Title of the map

copyright (str): Copyright for the map

googlekey (str): Google Maps API key from

http://code.google.com/apis/maps/signup.html

bingkey (str): Bing Maps API key from https://www.bingmapsportal.com/

nb_processes (int): Number of processes to use for tiling.

History

0.1.9 (2020-09-30)

• Enabling GDAL Exceptions.

• Ensuring tmscompatible option in tile generation and calculation is bool instance.

0.1.8 (2020-09-23)

• Fix AttributeError gdal2tiles.generate_tiles(..., profile='raster', kml=True). Fix issue #14.

0.1.7 (2020-06-03)

• Add tile_size option on generate_tiles to allow custom tile sizes.

• Small documentation updates.

• Improve basic tests and test against multiple versions of GDAL.

0.1.6 (2020-01-03)

• Fix some of GDAL installation issues.

• Use pygdal package instead of GDAL dependency.

0.1.5 (2018-08-14)

• Bug fix.

0.1.4 (2018-08-14)

• Accept list or tuple in specifying tile generation zoom level.

0.1.3 (2018-07-31)

• Use billard for multiprocessing if available.

0.1.2 (2018-05-16)

• Bug fix in generate_tiles().

0.1.1 (2018-05-10)

• Clean the source code.

• Setup documentation

• Setup testing environment

0.1.0 (2018-05-06)

• First release on PyPI.