Streams OSM data in XML format to GeoJSON.

npm install osm2geojson
12 downloads in the last week
21 downloads in the last month


Streams OSM data in XML format to GeoJSON. Generates GeoJSON features from OSM ways and nodes.

Install it globally

npm install -g osm2geojson

Use it from the command line like this

osm2geojson -b "[-111.01032257080078,31.314701127170984,-110.68004608154295,31.447492524518246]"

That will download data from the specified area. Make sure it is not more than 0.25 sq.deg. If you have an extracted XML file, you can...

osm2geojson -f /path/to/osm.xml

You may want to redirect the results to a file unless you can read really fast...

osm2geojson -f /path/to/osm.xml > osm.geojson

Use it in another project like this

npm install osm2geojson

... then in your own scripts:

osm2geojson = require("osm2geojson")();

Optional filtering and mapping

The function returned by require('osm2geojson') can take two optional arguments -- a filter function and a mapping function.

A "filter function" should return true for the features you care about, and false for those you don't. Those that return false will not be included in the final GeoJSON FeatureCollection.

For example:

osm2geojson = require("osm2geojson")(function (feature) {
    return feature.geometry.type === 'Polygon';

This will provide an output stream of features that only contains polygons.

The second argument you can provide is a "mapping function". This function accepts one GeoJSON feature, and returns a "transformed" version of the feature. You can use this to adjust the features however you wish. For example:

osm2Geojson = require("osm2geojson")(null, function (feature) {
    return {
        type: "Feature",
        properties: {
            name: feature.properties.name.toLowerCase() || 'default name',
            transformedWith: 'osm2geojson',
            originalProperties: feature.properties
        geometry: feature.geometry    
npm loves you