Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Mapnik implemention of Mapbox Vector Tile specification

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples
proto
python
src
test
.gitignore
.npmignore
.travis.yml
CHANGELOG.md
LICENSE
Makefile
README.md
package.json

README.md

mapnik-vector-tile

Build Status

A high performance library for working with vector tiles.

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

Depends

  • Mapnik > = v2.2.x: libmapnik and mapnik-config
  • 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

apt-get install libprotobuf7 libprotobuf-dev protobuf-compiler
apt-add-repository ppa:mapnik/v2.2.0
apt-get update && apt-get install libmapnik libmapnik-dev

OS X Dependencies Installation

brew install protobuf
brew install mapnik

Building

Just type:

make

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

Then include vector_tile.pb.cc in your code. The rest is header only.

Tests

Run the C++ tests like:

make test

Examples

C++

See examples in examples/c++

Python

These require the protobuf python bindings and the rtree library which can be installed like:

sudo apt-get install libspatialindex-dev
pip install protobuf rtree

To build and test the python example code do:

make python && make python-test

Run the example code:

python examples/python/hello-world.py

Authors

See also

Something went wrong with that request. Please try again.