mbtiles4j

An MBTiles server written in Java.

Configuration

Edit the mbtiles4j.properties file in src/main/resources to configure your MBTiles databases:

tile-dbs = db1,db2,db3

db1.path = /path/to/your/database1.mbtiles
db2.path = /path/to/your/database2.mbtiles
db3.path = /path/to/your/database3.mbtiles

The name specified in this file will be the name used in the URL to access the tiles, e.g. the db1 tiles in the example configuration will be available at htp://<address>:<port>/mbtiles4j/db1/z/x/y.png.

Build & Deployment

Type in

mvn package

and deploy the mbtiles4j.war file found in target/ to an application server of your choice.

Usage Example (Leaflet)

This is an example of how to use the tile server as a source for a Leaflet-based web app. Keep in mind that tiles are served according to TMS spec, i.e. you'll get a twisted map with mixed-up tiles unless you configure your maps solution accordingly.

  <script src="leaflet.js"></script>
  <script>
    var map = L.map('map');
    L.tileLayer('http://localhost:8080/mbtiles4j/db1/{z}/{x}/{y}.png', {
      tms: true
    }).addTo(map);
  </script>