Skip to content

Latest commit

 

History

History
94 lines (61 loc) · 2.55 KB

README.md

File metadata and controls

94 lines (61 loc) · 2.55 KB
Raw

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:

west east

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
  1. Start MongoDB

In another terminal:

mkdir db
cd db
mongod --dbpath .
  1. 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
  1. Import a shapefiles to the database

In another terminal:

node import.js

  1. Run test.js

    node test.js

Tileserver for debuging

The code from this repo was used to build simple tile server. Client side is basefd on Leaflet.

To use it, run:

cd tileserver/
npm install express generic-pool mapnik mongodb
node import.js coastline shp/ne_10m_coastline.shp
node server.js

Server will start. To see the results, open http://localhost:10000/ in the web browser.