MapBox Mbtiles Utilities
Project description
Mapbox MBtiles Utilities
A Python 2.7 and 3 library for working with Mabox mbtiles v1.1
Features
Provides a lighweight Python API for reading and writing mbtiles files.
Mabox mbtiles v1.1 allow you to store geographic data as rendered image tiles or as vector tiles, along with associated metadata.
Installation
pip install pymbtiles
To install from master branch on GitHub using pip:
pip install git+https://github.com/consbio/pymbtiles.git#egg=pymbtiles --upgrade
Usage
Python API
open for reading and read a tile:
from pymbtiles import MBTiles
with MBtiles('my.mbtiles') as src:
tile_data = src.read_tile(z=0, x=0, y=0)
returns tile data in bytes.
open for writing (existing file will be overwritten):
with MBtiles('my.mbtiles', mode='w') as out:
out.write_tile(z=0, x=0, y=0, tile_data)
or write a bunch of tiles at once:
from pymbtiles import MBTiles, Tile
tiles = (
Tile(z=1, x=0, y=0, tile_data=first_tile),
...
)
with MBtiles('my.mbtiles', mode='w') as out:
out.write_tiles(tiles)
Use r+
mode to read and write.
Metadata is stored in the meta
attribute of the mbtiles instance:
with MBtiles('my.mbtiles') as src:
metadata = src.meta
This metadata is stored in the metadata
table in the mbtiles file, and contains
a number of records required or optional under the
mbtiles specification .
To update metadata:
with MBtiles('my.mbtiles', 'r+') as out:
out.meta['some_key'] = 'some_value'
You can set several values at once by passing in a new dict
object:
with MBtiles('my.mbtiles', 'w') as out:
out.meta = my_metadata_dict
Listing available tiles
To list available tiles in the tileset:
with MBtiles('my.mbtiles') as src:
for tile_coords in src.list_tiles(): # [TileCoordinate(z, x, y)...]
...
WARNING: for large tilesets, this can exceed available memory.
To list available tilesets for large tilesets, use:
with MBtiles('my.mbtiles') as src:
for batch in src.list_tiles_batched():
for tile_coords in batch: # [TileCoordinate(z, x, y)...]
...
Set operations
The ops
module provides extend
, union
, and difference
functions to perform set operations on tilesets.
Extend a tileset with new tiles from a second:
extend(source_filename, target_filename)
Create a new tileset with unique tiles combined from both left and right tilesets:
union(left_filename, right_filename, out_filename)
Create a new tileset from the tileset in the left tileset not present in the right tileset:
difference(left_filename, right_filename, out_filename)
Tile Scheme
Tiles are output to mbtiles format in xyz tile scheme.
Possibly useful:
mbtileserver
: a lightweight Go tile servertpkutils
: a library for converting ArcGIS tile cache to mbtiles
Changes :
0.5.0
- added
zoom_range
,row_range
,col_range
to provide basic information about tiles available in the tileset
0.4.0
- added
list_tiles
to list tiles andlist_tiles_batch
to list tiles in batches - added
ops
module withextend
,union
,difference
functions
0.3.0
- all write-like operations for metadata and tiles are now overwrite by default
Credits:
Inspired by:
SQL for creating mbtiles database derived from node-mbtiles
License:
See LICENSE.md
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
Built Distribution
File details
Details for the file pymbtiles-0.5.0.tar.gz
.
File metadata
- Download URL: pymbtiles-0.5.0.tar.gz
- Upload date:
- Size: 7.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b4eb2c470d2eb3d94627cdc8a8ae448b8899af2dd696f9a5eca706ddf8293b58 |
|
MD5 | 81e6fc4253edfd164004ea442fbaa995 |
|
BLAKE2b-256 | 75ff9ae83bb0cf6c504d675b917eae3ad9e9f919fda3fea51de9f737ac0ccf27 |
File details
Details for the file pymbtiles-0.5.0-py3-none-any.whl
.
File metadata
- Download URL: pymbtiles-0.5.0-py3-none-any.whl
- Upload date:
- Size: 9.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91c1c2fa3e25f581d563a60e705105f7277b0dbb9ff727c8c28cb66f0f891c84 |
|
MD5 | 1bb90b8e49c2eb52a9fd8f2817375497 |
|
BLAKE2b-256 | 82baa05974655e73d7937b8e5438bf7ca5dba0b7d84dc67e98fb40c81dc92fca |