Landez manipulates tiles, builds MBTiles, does tiles compositing and arrange tiles together into single images.
Tiles can either be obtained from a remote tile service URL, from a local Mapnik stylesheet, a WMS server or from MBTiles files.
For building MBTiles, Landez embeds mbutil from Mapbox https://github.com/mapbox/mbutil at the final stage. The land covered is specified using a list of bounding boxes and zoom levels.
Landez is pure python and has no external dependency.
However, it requires mapnik if the tiles are rendered locally. :
sudo aptitude install python-mapnik
And PIL to blend tiles together or export arranged tiles into images. :
sudo aptitude install python-imaging
Using a remote tile service (OpenStreetMap.org by default): :
import logging
from landez import MBTilesBuilder
logging.basicConfig(level=logging.DEBUG)
mb = MBTilesBuilder(remote=True, cache=False)
mb.add_coverage(bbox=(-180.0, -90.0, 180.0, 90.0),
zoomlevels=[0, 1])
mb.run()
Please respect Tile usage policies <http://wiki.openstreetmap.org/wiki/Tile_usage_policy>
Using mapnik to render tiles: :
import logging
from landez import MBTilesBuilder
logging.basicConfig(level=logging.DEBUG)
mb = MBTilesBuilder(stylefile="yourstyle.xml", filepath="dest.mbtiles")
mb.add_coverage(bbox=(-180.0, -90.0, 180.0, 90.0),
zoomlevels=[0, 1])
mb.run()
import logging
from landez import MBTilesBuilder
logging.basicConfig(level=logging.DEBUG)
mb = MBTilesBuilder(mbtiles_file="yourfile.mbtiles", filepath="dest.mbtiles")
mb.add_coverage(bbox=(-180.0, -90.0, 180.0, 90.0),
zoomlevels=[0, 1])
mb.run()
mb = MBTilesBuilder(wms_server="http://yourserver.com/geoserver/wms",
wms_layers=["ign:departements"],
wms_options=dict(format="image/png",
transparent=True),
filepath="dest.mbtiles")
mb.add_coverage(bbox=([-0.9853,43.6435.1126,44.0639]))
mb.run()
from landez import MBTilesBuilder
# From a TMS tile server
# tm = TilesManager(tiles_url="http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png")
# From a MBTiles file
tm = TilesManager(mbtiles_file="yourfile.mbtiles")
tiles = tm.tileslist(bbox=(-180.0, -90.0, 180.0, 90.0),
zoomlevels=[0, 1])
for tile in tiles:
tm.prepare_tile(tile) # download, extract or take from cache
tile_path = tm.tile_fullpath(tile)
...
Merge multiple sources of tiles (URL, WMS, MBTiles, Mapnik stylesheet) together. (requires python PIL)
For example, build a new MBTiles by blending tiles of a MBTiles on top of OpenStreetMap tiles :
mb = MBTilesBuilder(filepath="merged.mbtiles")
overlay = TilesManager(mbtiles_file="carto.mbtiles")
mb.add_layer(overlay)
mb.run()
Or composite a WMS layer with OpenStreetMap using transparency (40%):
ie = ImageExporter(wms_server="http://yourserver.com/geoserver/wms",
wms_layers=["img:orthophoto"])
overlay = TilesManager(remote=True)
mb.add_layer(overlay, 0.4)
mb.run()
Assemble and arrange tiles together into a single image. (requires python PIL)
Specify tiles sources in the exact same way as for building MBTiles files.
import logging
from landez import ImageExporter
logging.basicConfig(level=logging.DEBUG)
ie = ImageExporter(mbtiles_file="yourfile.mbtiles")
ie.export_image(bbox=(-180.0, -90.0, 180.0, 90.0), zoomlevel=3, imagepath="image.png")
from landez.reader import MBTilesReader
mbreader = MBTilesReader("yourfile.mbtiles")
# Metadata
print mbreader.metadata()
# Zoom levels
print mbreader.zoomlevels()
# Image tile
with open('tile.png', 'wb') as out:
out.write(reader.tile(z, x, y))
# UTF-Grid tile
print reader.grid(z, x, y, 'callback')
- Mathieu Leplatre <mathieu.leplatre@makina-corpus.com>
- Sergej Tatarincev
- Thanks to mbutil authors <https://github.com/mapbox/mbutil>
- Lesser GNU Public License