regional-diff.py has been developed and tested on a Debian/jessie GNU/Linux system with the following dependencies:
- osmosis (0.40.1+ds1-7)
- python (2.7.5-8)
- python-lxml (3.4.0-1)
- python-pyrss2gen (1.1-1)
It has been converted to Python3 with 2to3 on a Debian/bookwork GNU/Linux system and should work with the following package versions:
- osmosis (0.48.3-2)
- python3 (3.11.2-1+b1)
- python3-lxml (4.9.2-1+b1)
- python3-pyrss2gen (1.1-2)
To run the regional-diff.py via Podman an image can be created and the container started like so:
❯ podman build --tag=osm-regional-diff -f Dockerfile
❯ podman run --rm -it -v $(pwd):/code osm-regional-diff /bin/bash
First clone the repository:
$ git clone https://github.com/jkirk/osm-regional-diffs.git
View the help message output:
$ scripts/regional-diff.py --help :(
usage: regional-diff.py [-h] [-v] [-M | -H | -f FILE | --osmfile OSMFILE]
[--report | --ids-only | --ql-only | --rss-file RSS_FILE]
Print report of all modified ways and relations from Vorarlberg of the latest minutely or hourly replication diff file from planet.openstreetmap.org (or by a given diff file)
optional arguments:
-h, --help show this help message and exit
-v, --verbose increase verbosity
-M, --minutely use minutely diff file from planet.openstreetmap.org
(default)
-H, --hourly use hourly diff file from planet.openstreetmap.org
-f FILE, --file FILE use local osc.gz diff file (instead of downloading the
latest diff file from planet.openstreetmap.org)
--osmfile OSMFILE use local osm file (from osmosis or overpass API)
--report output report to stdout (default)
--ids-only output all way and relation IDs from given diff
--ql-only output Overpass QL
--rss-file RSS_FILE output / append report as rss file
regional-diff.py by default reports ways and relations with bicylce-tags[1] in
Vorarlberg which were modified in the last minute.
As it is very likely that there haven't been any changes in the last minute it
might make sense to test regional-diff.py with changes done in the last hour
or by providing a diff file. To do so run either:
$ scripts/regional-diff.py --hourly
or
$ scripts/regional-diff.py -f scripts/637.osc.gz
637.osc.gz was downloaded from
http://planet.openstreetmap.org/replication/hour/000/015/637.osc.gz which was
created on #Wed Jun 25 20:02:07 UTC 2014. This should be the sample output:
The following ways and relations (in Vorarlberg) have been modified in scripts/637.osc.gz
WAY: 69998530
http://www.openstreetmap.org/way/69998530/history
http://www.openstreetmap.org/changeset/23158682
WAY: 118905057
http://www.openstreetmap.org/way/118905057/history
http://www.openstreetmap.org/changeset/23158682
WAY: 289794459
http://www.openstreetmap.org/way/289794459/history
http://www.openstreetmap.org/changeset/23158682
WAY: 289794460
http://www.openstreetmap.org/way/289794460/history
http://www.openstreetmap.org/changeset/23158682
WAY: 289794461
http://www.openstreetmap.org/way/289794461/history
http://www.openstreetmap.org/changeset/23158682
RELATION: 13132
http://www.openstreetmap.org/relation/13132/history
http://www.openstreetmap.org/changeset/24003836
RELATION: 116941
http://www.openstreetmap.org/relation/116941/history
http://www.openstreetmap.org/changeset/23158682
To generate an RSS-file run:
$ scripts/regional-diff.py -f scripts/637.osc.gz --rss-file regional-diff.rss
Put the RSS-file to your htdocs folder and point your favourite RSS-Client to
that URL to subscribe that feed.
The RSS-File with an RSS-Item is only created if modification exist (in
Vorarlberg). An RSS-Item (of a modification) is created and appended on every
run of regional-diff.py (even if the modification is part of a previous item).
Please note that processing a daily-diff file is a very CPU and memory hungry task. Working with less than 16GB of RAM could cause the script to crash.
- PyRSS2Gen (version 1.1) taken from http://www.dalkescientific.com/Python/PyRSS2Gen.html