Oslandia / postile

Project migrated to: https://gitlab.com/Oslandia/postile

Home Page:https://gitlab.com/Oslandia/postile

Repository from Github https://github.comOslandia/postileRepository from Github https://github.comOslandia/postile

PostTile

Build Status Package version


Fast Mapbox Vector Tile Server mainly suited for the openmaptiles vector tile schema

Features

  • Support for PostGIS backend through a tm2source (as generated by OpenMapTiles)
  • Support for PostGIS single layers
  • Support for reading MBTiles
  • On-the-fly reprojection to web mercator EPSG:3857 (only for single layers)
  • Connection pooling and asynchronous requests thanks to asyncpg

Requirements

  • Python >= 3.6
  • for PostGIS backend, recent ST_AsMVT function. At least PostGIS >= 2.4.0.

Installation

pip install cython
pip install -e .
postile --help

Using a Docker container

Start Postile with:

docker run --network host oslandia/postile postile --help

Example of serving postgis layers individually

postile --pguser **** --pgpassword **** --pgdatabase mydb --pghost localhost --listen-port 8080 --cors

Then layer boundaries can be served with:

http://localhost:8080/boundaries/z/x/y.pbf?fields=id,name

fields is optional, and when absent only geometries are encoded in the vector tile.

Preview

The root endpoint will display a built-in viewer with mapbox-gl-js. In DEBUG mode the same page will also add some checkboxes to show tile boundaries and collision boxes (for labels).


For a concrete example using OpenMapTiles schema see this tutorial

About

Project migrated to: https://gitlab.com/Oslandia/postile

https://gitlab.com/Oslandia/postile

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:Python 81.6%Language:HTML 16.2%Language:Dockerfile 2.2%