This release is a pre-release and may not be stable for production use.
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.
INSTALL
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
USAGE
Building MBTiles files
Remote tiles
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>
Local rendering
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()
From an other MBTiles file
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()
From a WMS server
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()
Manipulate tiles
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)
...
Blend tiles together
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()
Export Images
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")
Extract MBTiles content
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')
LICENSE
Lesser GNU Public License
CHANGELOG
2.0.0-alpha (2012-05-23)
Refactoring of whole stack
1.8.2 (2012-03-27)
Fix Mapnik rendering
1.8.1 (2012-02-24)
Fix MBTiles cache cleaning
1.8 (2012-02-24)
WMS support
Tiles compositing
1.7 (2012-02-17)
Catch Sqlite exceptions
1.6 (2012-02-08)
UTF-Grid support for MBTiles files
1.5 (2011-12-07)
Subdomain support for tiles servers
Low level tiles manipulation
Use i18n
1.4 (2011-10-17)
Remove extra logging message of mbutil
1.3 (2011-09-23)
Export set of tiles into single image
1.2 (2011-06-21)
Raise exception if no tiles in coverages
1.1 (2012-04-18)
Move internals to landez module
Split projection into separate module
1.0 (2011-04-18)
Initial working version
8 maintainers
Metadata
8 maintainers
Release files for landez 2.0.0-alpha
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| landez-2.0.0-alpha.zip | 25.9 kB | Details |
Release files / landez-2.0.0-alpha.zip
| Download URL | landez-2.0.0-alpha.zip |
|---|---|
| Size | 25.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8ec4cbc8d1b3e69a71d14e87522e7340737a2e8bb9e0ae6284d600030af9f632
|
|
BLAKE2b-256 checksum How to use checksums |
e20ea89f4768d23099d0b6b116bba6d282d3e85013a35aa2bd1e3233569708a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
