xml2geojson-lite

a lightweight yet faster osm xml to geojson convertor - 4x faster than xmldom + osmtogeojson in most situations - implemented in pure JavaScript without any 3rd party dependency

Usage no npm install needed!

<script type="module">
  import xml2geojsonLite from 'https://cdn.skypack.dev/xml2geojson-lite';
</script>

README

xml2geojson-lite

A lightweight yet faster convertor for OSM data to GeoJSON - much faster than xmldom + osmtogeojson in most situations - implemented in pure JavaScript without any 3rd party dependency

Notice

After rounds of refactoring and feature enhancement, this package has been upgraded to osm2geojson-lite. Important changes include: 1) support the conversion from OSM/Overpass JSON; 2) support the exportation of any unreferenced geographic elements. From now on, the author's maintenance efforts will be shifted to this new package with richer features, so if applicable please stay with me by migrating your projects to osm2geojson-lite. Thanks!

Usage

nodejs library

Installation:

$ npm install xml2geojson-lite

Usage:

    const xml2geojson = require('xml2geojson-lite');
    let geojson = xml2geojson(osm_xml);

browser library

    <script src='your/path/to/xml2geojson-lite.js'></script>

    let geojson = xml2geojson(osm_xml);

API

osm2geojson(osm_xml, opts)

Converts OSM XML data to GeoJSON.

  • osm_xml: the OSM XML data, in String.
  • opts?: optional - the options object, right now only supports allFeatures option, when it is set to true, it will return a comprehensive GeoJSON object as FeatureCollection rather than a bare Polygon/MultiPolygon.

Reminder

Please fasten your seat-belt before run the test script (node test.js)

Node.JS version

ES5/ES6 features

Dependencies

  • No 3rd party dependency

License

Written in 2018 by tibetty xihua.duan@gmail.com