Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

mapnik datasource plugin for reading geodata from mongodb

branch: master
README.md

MongoDB input plugin for Mapnik

This is a connector to MongoDB data in the form of a Mapnik C++ plugin. MongoDB supports spatial indexig on a sphere for a Points, a LineStrings and a Polygons since version 2.4.

Usage

Input plugin accepts the following parameters:

  • host -- (optional) hostname to connect MongoDB [default: "localhost"]
  • port -- (optional) port to connect [default: 27017]
  • dbname -- (optional) database name to use [default: "gis"]
  • collection -- (required) collection to use

Example in XML:

<Datasource>
    <Parameter name="type">mongodb</Parameter>
    <Parameter name="collection">polygons</Parameter>
</Datasource>

Records in the database should have a "geometry" property with GeoJSON geometry (only Point, LineString and Polygon are supported), and a "properties" property, which contains an information about feature.

Example:

{
    geometry: {
        type: "LineString",
        coordinates: [ [ lng1, lat1 ], [ lng2, lat2 ], ... ]
    },
    properties: {
        name: "Long Hard Road",
        id: 32167,
        ...
    }
}

CAUTION: notice the Longitude, Latitude order.

Demo

Render result for test/test.js, source shape files in QGis screenshot:

westeast

Setup

1) Install MongoDB with C++ driver (libmongoclient)

Recommended to install from https://github.com/mongodb/mongo.git

git clone https://github.com/mongodb/mongo.git
cd mongo
git checkout r2.4.6
scons --full install

2) Start MongoDB

In another terminal:

mkdir db
cd db
mongod --dbpath .

3) Prepare test environment (optional)

The tests are written in Node.js v0.10.x for Mapnik v2.2.x.

cd test/
npm install mongodb mapnik

4) Import a shapefiles to the database

In another terminal:

node import.js

5) Run test.js

node test.js
Something went wrong with that request. Please try again.