Skip to content

Latest commit

 

History

History
41 lines (26 loc) · 2.11 KB

Readme.md

File metadata and controls

41 lines (26 loc) · 2.11 KB

JOSM plugin for reviewing changes before upload

Main montivation for this plugin was semi-automatic import of addresses/buildings in Slovenia. We created tool that generated changeset for mapper to use for import, but mapper needs to review all buildings before uploading, because source can have demolished buildings or misaligned/wrong size...

Reviewing changes was hard, hence this plugin was created which allows quick navigation between changes on ways/relations ignoring untagged nodes.

How to install

The Review plugin can be installed via JOSM plugin manager.

  • Open Preferences -> Plugins
  • Search for the plugin "Review Changes" and install it

How to use

  1. After installing plugin new pad should appear "Review List" in bottom-right corner of window. If not use "Windows"->"Review List" in main bar of window to toggle.
  2. Once you want to review changes you made, click on "Start Review" button, list will be filled with all changes.
  3. Use Control+Alt+Enter keyboard shortcut to mark current item in list reviewed and move to next one.
  4. There are also other shortcuts like Control+Alt+Up/Down to move up and down in list and Control+Alt+Right/Left to move between unreviewed changes

How to develop

We use Gradle plugin for developing JOSM plugins which simplifies things...

  • Install Gradle https://gradle.org/install/
  • Run gradle w to create wrapper in repo
  • Run ./gradlew run to compile and run JOSM which loads plugin

Debugging

  • Run ./gradlew debug
  • In VSCode start debugging

What this will do is start JOSM with listening for debugger to connect on port 2019, and VSCode will connect to that port and start debugging.

TODO/Future ideas

  • Additional window that shows tags changed of selected element
  • Additional overlay that shows old geometry of selected element

License

Since JOSM itself is GPL 3.0 it makes sense for this plugin to be too.