fgravin/baremaps

Vector tile server and pipeline built with Postgis and Java.

Baremaps

Baremaps is a vector tile server and pipeline for producing Mapbox vector tiles from OpenStreetMap and other data sources. The project is licensed under Apache License 2.0 and supported by Camptocamp.

It is inspired by Osmosis, but it comes with additional features, such as the ability to:

• Process data in parallel with the Stream API of Java
• Import data faster with the COPY API of Postgresql
• Create postgis geometries on the fly with JTS
• Create and serve customized Mapbox Vector Tiles

On the longer run, the aim of the project is to work with a variety of data sources in order to create highly specialized and customized maps.

State of the map

Quick Start

In order to run Baremaps, you first need to install Java 8.

Download and unzip the latest distribution. Add the /bin folder to your PATH variable:

wget https://github.com/baremaps/baremaps/releases/latest/download/baremaps.zip
unzip baremaps.zip
export PATH=$PATH:`pwd`/baremaps/bin

Calling the baremaps command should now result in an output similar to the following:

Usage: baremaps [COMMAND]
Commands:
  import
  update
  export
  serve

In order to run Baremaps, you need to setup a postgis database. The following docker image will allow you to jump start this installation:

docker run \
  --name baremaps-postgis \
  --publish 5432:5432 \
  -e POSTGRES_DB=baremaps \
  -e POSTGRES_USER=baremaps \
  -e POSTGRES_PASSWORD=baremaps \
  -d baremaps/postgis:latest

You can then start and stop the container with the following commands:

docker start baremaps-postgis
docker stop baremaps-postgis

Examples

Several examples illustrate how to import datasets in postgis and produce vector tiles.

• The OpenStreetMap example shows how to produce high resolution vector tiles.
• The NaturalEarth example shows how to produce low resolution vector tiles.
• The Contour example shows how to produce contours from a digital elevation model (DEM).
• The Buildings example shows how to 3D buildings from openstreetmap data.

Contributing

Contributions are welcome and encouraged. Please,checkout our code of conduct and contributing guidelines.