Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

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

Project description

gdal2tiles

https://img.shields.io/pypi/v/gdal2tiles.svg https://img.shields.io/travis/tehamalab/gdal2tiles.svg Documentation Status

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for gdal2tiles, version 0.1.9
Filename, size File type Python version Upload date Hashes
Filename, size gdal2tiles-0.1.9.tar.gz (201.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page