*Landez* builds MBTiles files either from a remote tile service URL or from a local Mapnik stylesheet.

The land covered is specified using a list of bounding boxes and zoom levels.

It uses *mbutil* from Mapbox https://github.com/mapbox/mbutil at the final stage to 
build the MBTiles file.


=======
INSTALL
=======

*Landez* requires nothing but python remote mode (specifying a tiles URL), but 
requires `mapnik` if the tiles are drawn locally. ::

    sudo aptitude install python-mapnik

=====
USAGE
=====

Remote tiles
============
Using a remote tile service (Cloudmade by default):
::

    import logging
    from landez import MBTilesBuilder

    logging.basicConfig(level=logging.DEBUG)
        
    mb = MBTilesBuilder(remote=True, cache=False)
    mb.add_coverage(bbox=(-90.0, -180.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=(-90.0, -180.0, 180.0, 90.0), 
                    zoomlevels=[0, 1])
    mb.run()


=======
AUTHORS
=======

    * Mathieu Leplatre <mathieu.leplatre@makina-corpus.com>
    * Thanks to mbutil authors <https://github.com/mapbox/mbutil>

=======
LICENSE
=======

    * Lesser GNU Public License
