node package manager



A Mapnik implemention of Mapbox Vector Tile specification.

Provides C++ headers that support rendering geodata into vector tiles and rendering vector tiles into images.

  • Master: Build Status
  • 0.6.x series: Build Status



Mapnik Vector Tile does not currently support Mapnik 3.1.x.

  • mapnik-vector-tile >=1.4.x depends on Mapnik >=v3.0.14
  • mapnik-vector-tile >=1.0.x depends on Mapnik >=v3.0.11
  • mapnik-vector-tile 1.0.0 to 0.7.x depends on Mapnik v3.0.x (until 3.0.0 is released this means latest mapnik HEAD)
  • mapnik-vector-tile 0.6.x and previous work with Mapnik v2.2.x or v2.3.x
  • You will need libmapnik and mapnik-config available
  • Protobuf: libprotobuf and protoc

Implementation details

Vector tiles in this code represent a direct serialization of Mapnik layers optimized for space efficient storage and fast deserialization. For those familiar with the Mapnik API vector tiles here can be considered a named array of mapnik::featureset_ptr whose geometries have been pre-tiled.

For more details see vector-tile-spec.

Ubuntu Dependencies Installation

sudo apt-get install -y libprotobuf7 libprotobuf-dev protobuf-compiler
sudo apt-add-repository --yes ppa:mapnik/nightly-2.3
sudo apt-get update -y
sudo apt-get -y install libmapnik=2.3.0* mapnik-utils=2.3.0* libmapnik-dev=2.3.0* mapnik-input-plugin*=2.3.0*

OS X Dependencies Installation

brew install protobuf
brew install mapnik


Just type:


This builds the protobuf C++ wrappers: and vector_tile.pb.h

Then include in your code. The rest is header only.


Run the C++ tests like:

make test



See examples in examples/c++


See also