django-mbtiles serves maps from MBTiles files using Django. It mainly relies on landez.

Checkout LiveMbtiles a simple maps catalog project that takes advantage of django-mbtiles.

INSTALL

Last stable version:

pip install django-mbtiles

Last development version:

pip install -e git+https://github.com/makinacorpus/django-mbtiles.git#egg=django-mbtiles

USAGE

• Add mbtilesmap to your INSTALLED_APPS
• Make sure you have 'django.core.context_processors.static' in your context processors
• Include mbtilesmap urls into your project

urlpatterns = patterns('',
    ...
    ...
    url(r'^', include('mbtilesmap.urls', namespace='mb', app_name='mbtilesmap')),
)

• Add the HTML header and call the template tag

{% load mbtilesmap_tags %}
...
{% block head %}
{% mbtilesmap_head %}
{{ block.super }}
{% endblock head %}

...
...
{% mbtilesmap filename %}

MBTiles files can be loaded from subfolders with MBTILES_ROOT setting.

{% mbtilesmap filename catalog="subfolder" %}

Example

You can find a working demo project (MBTiles maps browser livembtiles) in the example/ folder of the source tree (see dedicated README.rst file).

Cache with nginx

• Declare a cache zone in the http section :

http {
    ...
    proxy_cache_path  /var/cache/nginx levels=1:2 keys_zone=master:10m inactive=7d max_size=1g;
    proxy_temp_path /var/tmp/nginx;
}

Cache name will be master, index will be 10m, will last 7d and have a maximum size of 1g.

• Serve from cache for a specific location :

location @proxy {
    ...
    proxy_cache             master;
    proxy_cache_key         $$scheme$$host$$uri$$is_args$$args;
    proxy_cache_valid       200  7d;
    proxy_cache_use_stale   error timeout invalid_header;
}

See example project's buildout for deployment automation.

AUTHORS

• Mathieu Leplatre <mathieu.leplatre@makina-corpus.com>
• Andreas Trawoeger

LICENSE

• Lesser GNU Public License

CHANGELOG

1.3.0 (2013-09-18)

• Safety check if root folder is empty, with no sub-folders
• Add grids urls in TileJSON

1.2.1 (2013-09-16)

• Setup was zip safe, fixed it.

1.2 (2013-09-13)

• Changed behaviour, looks for subfolders instead of multiple paths in MBTILES_ROOT

1.1 (2013-09-11)

• Add ability to load MBTiles files from several folders

1.0

• Initial version