mapnik-vector-tile

mapnik-vector-tile

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:
• 0.6.x series:

Depends

• mapnik-vector-tile >=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

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++

Authors

• Artem Pavlenko
• Dane Springmeyer
• Konstantin Käfer

See also

• http://mike.teczno.com/notes/postgreslessness-mapnik-vectiles.html
• https://github.com/jones139/ceramic
• https://github.com/opensciencemap/vtm

Changelog

1.0.0

Extensive redesign in mapnik-vector-tile to properly support 2.0 of the Mapbox Vector Tile specification. A large number of changes have occured but a summary of these changes can be described as:

• Removed backend_pbf
• Changed processor interface
• Removed requirement on libprotobuf Tile class when using the library.
• Created new tile and merc_tile class
• Added different processing logic for v1 and v2 decoding
• Solved several small bugs around decoding and encoding
• Added many more exceptions around the processing of invalid tiles.
• Added load_tile and composite headers
• Organized tests directory and added many more tests
• Removed the concept of is_solid
• Removed the concept of path_multiplier
• Fixed bugs in empty concept.
• tile_size is now directly related to the layer extent
• Encoding no longer allows repeated points in lines and polygons
• Corrected issues with winding order being reversed in some situations when decoding polygons
• Changed the default configuration values for processor