osm-adiff-parser

Parses OSM augmented diff XML and returns plain JS objects representing elements mentioned in the diff, grouped by changeset ID.

Installation

npm install @osmcha/osm-adiff-parser

Usage

1import parser from 'osm-adiff-parser';
2let changesets = await parser(changesetXmlString);

Example input & output

Input (an augmented diff of a simple changeset which added a couple of tags to an existing node)

1<osm version="0.6" generator="Overpass API not used, but achavi detects it at the start of string; OSMExpress/python/examples/augmented_diff.py">
2  <note>The data included in this document is from www.openstreetmap.org. The data is made available under ODbL.</note>
3  <action type="modify">
4    <old>
5      <node id="2523603738" version="2" user="TheRomanP" uid="3844185" timestamp="2024-06-05T13:51:12Z" changeset="152289357" lon="-121.2881568" lat="47.6647943">
6        <tag k="highway" v="trailhead" />
7      </node>
8    </old>
9    <new>
10      <node id="2523603738" version="3" timestamp="2024-08-20T21:36:16Z" uid="8794039" user="jake-low" changeset="155530622" lat="47.6647943" lon="-121.2881568">
11        <tag k="highway" v="trailhead" />
12        <tag k="name" v="Necklace Valley Trailhead" />
13        <tag k="operator" v="US Forest Service" />
14        <tag k="website" v="https://www.fs.usda.gov/recarea/mbs/recarea/?recid=80228" />
15      </node>
16    </new>
17  </action>
18</osm>

Output

1{
2  "155530622": [
3    {
4      "id": "2523603738",
5      "version": "3",
6      "timestamp": "2024-08-20T21:36:16Z",
7      "uid": "8794039",
8      "user": "jake-low",
9      "changeset": "155530622",
10      "lat": "47.6647943",
11      "lon": "-121.2881568",
12      "old": {
13        "id": "2523603738",
14        "version": "2",
15        "user": "TheRomanP",
16        "uid": "3844185",
17        "timestamp": "2024-06-05T13:51:12Z",
18        "changeset": "152289357",
19        "lon": "-121.2881568",
20        "lat": "47.6647943",
21        "action": "modify",
22        "type": "node",
23        "tags": {
24          "highway": "trailhead"
25        }
26      },
27      "action": "modify",
28      "type": "node",
29      "tags": {
30        "highway": "trailhead",
31        "name": "Necklace Valley Trailhead",
32        "operator": "US Forest Service",
33        "website": "https://www.fs.usda.gov/recarea/mbs/recarea/?recid=80228"
34      }
35    }
36  ]
37}

History

This package is a fork of mapbox/osm-adiff-parser which is no longer maintained. Version 2.0.0 of @osmcha/osm-adiff-parser contains breaking API changes compared to version 1.1.0 of osm-adiff-parser. See the CHANGELOG for more details.