Bindings to mapnik for node.js
C++ JavaScript Shell Batchfile Python HTML Other
Failed to load latest commit information.
bench Remove parse in benchmark Jan 22, 2016
bin consistently import mapnik from relative path Mar 14, 2016
deps/clipper Updated the clipper to fix a rare bug May 4, 2016
docs Move and expand Jun 14, 2015
documentation re-render docs with config file [skip ci] May 3, 2016
lib Removed lib protobuf updated vector tiles. Jan 27, 2016
scripts include function def [publish docs] Aug 11, 2016
src include params in options [publish docs] Aug 11, 2016
test persist image buffer in fromBufferSync Aug 11, 2016
tools better c++ style as per mapnik conventions Apr 12, 2012
.gitattributes [skip ci] shapefile/geojson test, revert 183d8d9 Aug 2, 2015
.gitignore Merge branch 'master' into clipper_fix Mar 8, 2016
.npmignore npmignore nvm directory [skip ci] Mar 29, 2016
.travis.yml simplify .travis.yml Aug 10, 2016 Bump to 3.5.13 [republish binary] Apr 19, 2016 update Jun 30, 2016
LICENSE.txt update licence year Apr 16, 2012
Makefile Added coveralls integration Mar 2, 2015 [docs] refresh source build instructions - refs #613 Mar 14, 2016
appveyor.yml Remove MAPNIK_GIT from appveyor.yml Jul 12, 2016
binding.gyp enable debug builds + binary publishing Mar 4, 2016
common.gypi Windows: Custom "ProgramDatabaseFile" to avoid naming conflict with '… Feb 15, 2015 let gyp control if mapnik_settings.js needs rebuilt Apr 1, 2014
index.html fix relative URLs for docs [skip ci] Mar 1, 2016
package.json bump to v3.5.14 [publish binary] Aug 11, 2016
vcbuild.bat use new mapnik-sdk Aug 26, 2014


Bindings to Mapnik for node.


Build Status Build status Coverage Status


Render a map from a stylesheet:

var mapnik = require('mapnik');
var fs = require('fs');

// register fonts and datasource plugins

var map = new mapnik.Map(256, 256);
map.load('./test/stylesheet.xml', function(err,map) {
    if (err) throw err;
    var im = new mapnik.Image(256, 256);
    map.render(im, function(err,im) {
      if (err) throw err;
      im.encode('png', function(err,buffer) {
          if (err) throw err;
          fs.writeFile('map.png',buffer, function(err) {
              if (err) throw err;
              console.log('saved map image to map.png');

Convert a jpeg image to a png:

var mapnik = require('mapnik');

Convert a shapefile to GeoJSON:

var mapnik = require('mapnik');
var ds = new mapnik.Datasource({type:'shape',file:'test/data/world_merc.shp'});
var featureset = ds.featureset()
var geojson = {
  "type": "FeatureCollection",
  "features": [
var feat =;
while (feat) {
    feat =;

For more sample code see the tests and sample code.


  • Node v0.10.x or v0.12.x (v0.12.x support requires node-mapnik >= v3.1.6)
  • C++11 compatible C++ runtime library


If you hit an error like:

Error: /usr/lib/x86_64-linux-gnu/ version `GLIBCXX_3.4.18' not found

This means your Linux distributions libstdc++ library is too old (for example you are running Ubuntu Precise rather than Trusty). To work around this upgrade libstdc++:

sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
sudo apt-get update -q
sudo apt-get install -y libstdc++6

To upgrade libstdc++ on travis (without sudo) you can do:

language: cpp

sudo: false

     - ubuntu-toolchain-r-test
     - libstdc++6 # upgrade libstdc++ on linux to support C++11


Just do:

npm install mapnik@3.x

Note: This will install the latest node-mapnik 3.x series, which is recommended. There is also an 1.x series which maintains API compatibility with Mapnik 2.3.x and 2.2.x and a v0.7.x series which is not recommended unless you need to support Mapnik 2.1 or older.

By default, binaries are provided for:

On those platforms no external dependencies are needed.

Other platforms will fall back to a source compile: see Source Build for details.

Binaries started being provided at node-mapnik >= 1.4.2 for OSX and Linux and at 1.4.8 for Windows.

Windows specific

NOTE: Windows binaries for the 3.x series require the Visual C++ Redistributable Packages for Visual Studio 2015:

See for more details.

The 1.x series require the Visual C++ Redistributable Packages for Visual Studio 2013:

Source Build

To build from source you need:

  • Mapnik >= v3.0.10

Install Mapnik using the instructions at:

Confirm that the mapnik-config program is available and on your ${PATH}.

Then run (within the cloned node-mapnik directory:

npm install --build-from-source

Windows specific

Windows builds are maintained in

Using node-mapnik from your node app

To require node-mapnik as a dependency of another package put in your package.json:

"dependencies"  : { "mapnik":"*" } // replace * with a given semver version string


To run the tests do:

npm test


BSD, see LICENSE.txt