fences-builder

0.1.2 • Public • Published

fences-builder

This module extracts administrative boundary polygons from openstreetmap data files. It's currently using node-osmium to do most of the work, and simply filtering the generated polygons using tags.

NPM

Note: you will need node and npm installed first.

The easiest way to install node.js is with nave.sh by executing [sudo] ./nave.sh usemain stable

Installation

$ npm install fences-builder

Usage

standalone utility

This utility needs the following parameters.

Parameter Description
inputFile Path to input file. Must be a valid OSM data file (pbf, osm, etc.)
outputDir Path to an existing directory that will contain output files for each admin_level.
$ fences-builder --inputFile=<file> --outputDir=<dir>

dependency module

var FencesBuilder = require('fences-builder');
 
var builder = new FencesBuilder(inputFile, outputDir);
 
builder.start(function (err, results) {
  if (err) {
    console.error(colors.red('[Error]:'), err.message);
  }
  else {
    console.log(colors.blue('[Results]:'), results);
  }
});

Known Issues

  • Osmium parser has been separated into a child process because it doesn't respect node's event loop.
  • Cannot run with full planet file as input. Process runs out of memory. It is recommended that the planet data is pre-filtered using osmfilter or some other similar utility.

Running Tests

$ npm test

Note: the tests don't attempt to verify osmium functionality, we trust that things are working as expected there.

Continuous Integration

Build Status

Dependencies (11)

Dev Dependencies (5)

Package Sidebar

Install

npm i fences-builder

Weekly Downloads

1

Version

0.1.2

License

MIT

Last publish

Collaborators

  • missinglink
  • dianashk
  • julian_mapzen
  • pelias
  • trescube