Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

mapnik-vector-tile

Package Overview
Dependencies
Maintainers
2
Versions
79
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

mapnik-vector-tile

Mapnik vector tile API

  • 0.4.1
  • Source
  • npm
  • Socket score

Version published
Maintainers
2
Created
Source

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.

A vector tile can consist of one or more ordered layers identified by name and containing one or more features.

Features contain attributes and geometries: either point, linestring, or polygon.

Geometries are stored as an x,y,command stream (where command is a rendering command like move_to or line_to). Geometries are clipped, reprojected into spherical mercator, converted to screen coordinates, and delta and zigzag encoded.

Feature attributes are encoded as key:value pairs which are dictionary encoded at the layer level for compact storage of any repeated keys or values. Values use variant type encoding supporting both unicode strings, boolean values, and various integer and floating point types.

Vector tiles are serialized as protobuf messages which are then zlib compressed.

The assumed projection is Spherical Mercator (epsg:3857).

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

FAQs

Package last updated on 24 Feb 2014

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc