JOSM Remote Route Helper
Helper-Version 1.5.9
Generator-Version 1.0.12

Enthaltene Dateien:
- josm-remote-route-helper.ps1
- starter.bat
- speedcommander-josm-route-helper.scmac
- josm-helper.ico
- README.txt

Wozu dient das Programm?
Der JOSM Remote Route Helper nimmt GeoJSON- oder JSON-Routendateien entgegen
und bereitet sie für die Weitergabe an JOSM vor.
Das ist besonders hilfreich, wenn mit Tour Analyzer Plus Routen in GeoJSON-Form
gezeichnet oder vorbereitet wurden und diese Daten danach in JOSM geprüft,
ergänzt oder weiterverarbeitet werden sollen.

Hintergrund:
Das Programm wurde für das Kartieren des Knoten-Netzwerks im Mühlhäuser Stadtwald
vorbereitet. Es hilft dabei, lokal gezeichnete oder vorbereitete Routen aus
GeoJSON-Dateien einfacher nach JOSM zu übergeben.

Typischer Ablauf ohne SpeedCommander:
1. ZIP entpacken.
2. Den entpackten Ordner dauerhaft ablegen (z. B. C:\Users\DEIN_BENUTZER\JOSM\)
3. starter.bat per Doppelklick starten.
4. Im Programm eine lokale .geojson- oder .json-Datei auswählen.
5. Die Route wird an JOSM übergeben.

Typischer Ablauf mit SpeedCommander:
1. ZIP in deinen persönlichen JOSM-Ordner entpacken,
   z. B. C:\Users\DEIN_BENUTZERNAME\JOSM\
2. Im SpeedCommander das Makro speedcommander-josm-route-helper.scmac einrichten.
3. Eine lokale .geojson- oder .json-Datei markieren.
4. Das Makro starten.
5. Die markierte Datei wird direkt an josm-remote-route-helper.ps1 übergeben.

Wichtig für das SpeedCommander-Makro (Pfad-Angabe):

Am besten verwendest du %USERPROFILE% – das funktioniert in den meisten Fällen:
Const PS1_PATH = "%USERPROFILE%\JOSM\josm-remote-route-helper.ps1"

ABER: In einigen SpeedCommander-Versionen wird %USERPROFILE% nicht korrekt
aufgelöst. Dann findet das Makro die PowerShell-Datei nicht.

→ Für diese Fälle musst du den absoluten Pfad eintragen, z. B.:
Const PS1_PATH = "C:\Users\DeinBenutzername\JOSM\josm-remote-route-helper.ps1"

Prüfe also im Fehlerfall, ob dein SpeedCommander die Umgebungsvariable
unterstützt – und ersetze sie ggf. durch den festen Pfad.

SpeedCommander-Makro:
Mit dem Makro speedcommander-josm-route-helper.scmac ist es möglich, eine lokale
Routendatei direkt an die PowerShell-Datei zu übergeben.
Das Makro liest die markierte oder fokussierte Datei im aktiven
SpeedCommander-Fenster aus und startet josm-remote-route-helper.ps1 mit den
passenden Parametern.

Startmodi im Makro:
START_MODE = 1   → Produktivmodus. PowerShell wird versteckt gestartet.
                   Eine Logdatei wird geschrieben.
START_MODE = 2   → Diagnosemodus. PowerShell bleibt sichtbar und offen.
                   Hilft bei der Fehlersuche.

Fehlerdiagnose:
Das SpeedCommander-Makro schreibt bei Problemen eine Logdatei nach:
%TEMP%\josm-remote_last_run.log

Bei einem Fehler wird diese Datei automatisch mit Notepad geöffnet.

Wenn nichts passiert:
1. Prüfen, ob die Datei josm-remote-route-helper.ps1 wirklich in deinem
   persönlichen JOSM-Ordner liegt (z. B. C:\Users\DEIN_NAME\JOSM\)
2. Prüfen, ob in der .scmac-Datei der Pfad bei Const PS1_PATH exakt stimmt.
3. Eine .geojson- oder .json-Datei im SpeedCommander markieren.
4. Bei Bedarf START_MODE im Makro auf 2 stellen und erneut testen.

Links:
Tour Analyzer Plus:
https://gabischatz.de.cool/VeloLog/tour-analyzer-plus.html

Video Tour Analyzer Plus Teil 1:
https://youtu.be/u4m8UiuJG1s

Video Tour Analyzer Plus Teil 2:
https://youtu.be/fOgraKkVKTM?si=AuCVfV0uLqL1grBu

Fietsknoop Mühlhausen:
https://www.fietsknoop.nl/plannerplugin/muehlhausenThueringenRadfahren

Erstellte Stadtwald-Routen:
https://overpass-osm.de.cool/Routen/DE/Thueringen/MHL/MHL.html

Alle Routen im Stadtwald:
https://overpass-osm.de.cool/Routen/DE/Thueringen/MHL/tour-analyzer.html?list=https://overpass-osm.de.cool/Routen/DE/Thueringen/MHL/MHL-files.json