Skip to main content

ArcGIS Tile Package Utilities

Project description

A Python 3.5 library for reading tiles and exporting tools from ArcGIS Tile Packages which contain tile caches using the ArcGIS Compact Tile Cache

Build Status Coverage Status


  • easy access to tiles in a tile package

  • export to mbtiles, for hosting on any of a variety of mbtiles servers, such as mbtileserver


Python API

Open a tile package:

from tpkutils import TPK

tpk = TPK('my_tiles.tpk')

Tile access

You can iterate over individual tiles - for instance, to save to disk.
Tiles are returned as a namedtuple: Tile(z, x, y, data):
for tile in tpk.read_tiles():
    with open('{0}_{1}_{2}.png'.format(tile.x, tile.y, tile.z), 'wb') as outfile:

You can also just read tiles for a given zoom level or levels:

By default, tiles are returned according to the ArcGIS tile scheme.
To output tiles in xyz scheme, the y-value needs to be flipped:

Note: no direct interface to read a single tile or tiles specified by x or y is currently provided.

Export to mbtiles

You can export a tile package to a MapBox mbtiles v1.1 file:


Or just export a subset of zoom levels:

tpk.to_mbtiles('fewer_tiles.mbtiles', zoom=[0,1,2,3,4])

Note: tiles are output to mbtiles format in xyz tile scheme.

Also note: mixed format tiles are not supported for export to mbtiles.


All tile packages are assumed to follow the Web Mercator Tiling Scheme (Google/Bing/etc), and be in the Web Mercator coordinate reference system.

Developed and tested using image tile packages created using ArcGIS 10.3; however, these appear to use the 10.1 compact bundle format.

ArcGIS Server 10.3 introduced a new version of the compact bundle, which is not handled here yet. If you want this, please submit an issue with a small test file in 10.3 format.

Tile packages created using other versions may not work correctly (please log an issue with test data).

Versions from ArcGIS older than 10.1 are unlikely to be supported.

No support for Python 2 is planned.


Tile package format is described here.

Inspired by: * tiler-arcgis-bundle * mbutiles * node-mbtiles

SQL for creating mbtiles database derived from node-mbtiles

ArcGIS is a trademark of of ESRI and is used here to refer to specific technologies. No endorsement by ESRI is implied.

Project details

Download files

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

Source Distribution

tpkutils-0.1.0.tar.gz (6.9 kB view hashes)

Uploaded Source

Built Distribution

tpkutils-0.1.0-py3.5.egg (18.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page