Caches entlang einer Route

Version vom 18. Mai 2020, 16:14 Uhr von FriedrichFröbel (Diskussion | Beiträge) (bessere Formulierung)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Für Linux gibt es ein Skript, mit dem eine GPX-Datei erzeugt werden kann, die alle Caches entlang einer Route beinhaltet. Das Skript wurde durch ka_be entwickelt und im Opencaching-Forum zur Verfügung gestellt.

Parameter

FriedrichFröbel hat eine Version mit grafischer Oberfläche auf Basis von Java entwickelt. Er kümmert sich auch um den Einbau neuer Funktionen in das Bash-Skript und die Behebung eventuell vorhandener Fehler.

Das Skript sucht sich entweder selbst die Route oder es wird mit einer GPX-Datei aufgerufen, die die geplante Route enthält – diese kann bspw. bei Openrouteservice.org erzeugt werden. Dann sammelt es via OKAPI alle nötigen Daten zusammen. Es sendet auf Wunsch die GPX-Daten zu einer E-Mail-Adresse. Ab 500 Caches wird eine weitere GPX-Datei angelegt und versendet.

Damit das Skript funktioniert, muss GPSBabel installiert sein, es wird für den E-Mail Versand SendEmail, zum Skript-Download curl benötigt. Gestartet wird das Skript dann im Terminal, wobei man diverse Parameter angeben muss/kann, wie Benutzernamen, Start, Ziel.

Folgende Angaben sollten für Start/Ziel funktionieren:

  • Koordinaten im Format lat,lng ohne Leerzeichen, auf . und , achten -> 48.321,9.123
  • Ortsnamen
  • Straße, Ortsnamen

Das Skript ruft dann die erforderlichen Daten ab und anschließend befindet sich im Skriptverzeichnis die fertige GPX-Datei mit allen Caches entlang der vorgegebenen Route. Diese kann dann mit der Software der eigenen Wahl weiter verarbeitet, direkt auf das GPS geschoben oder ans Handy versendet werden.

Die Installation unter Linux

 
Fertig durchgelaufenes Skript
  1. Terminal starten, Shortcut: Strg + Alt + T, das Terminal wird im Home-Verzeichnis geöffnet.
  2. Lege ein neues Verzeichnis an mit
    mkdir oc_car
  3. Wechseln in das Verzeichnis mit
    cd oc_car
  4. Pakete (unter Debian Linux und Derivaten) installieren - soweit nötig - mit
    sudo apt-get install gpsbabel
    sudo apt-get install bc
    sudo apt-get install sendemail
    sudo apt-get install curl
  5. Skript herunterladen mit
    curl https://raw.githubusercontent.com/FriedrichFroebel/oc_car/master/oc_car.sh > oc_car.sh
  6. Skript zur Verarbeitung der (Start- und Ziel-)Koordinaten herunterladen mit
    curl https://raw.githubusercontent.com/dominictarr/JSON.sh/master/JSON.sh > JSON.sh
  7. Skripte ausführbar machen mit
    sudo chmod 744 oc_car.sh
    sudo chmod 744 JSON.sh
  8. Ausführen mit
    ./oc_car.sh

Nach dem ersten Durchlauf wird die Datei oc_car.conf erstellt. Hier bitte die E-Mail-Daten hinterlegen, wenn ein E-Mail-Versand erwünscht ist.

Die Installation unter Windows

Vorbereitungen/Voraussetzungen

  1. Installation von Git Bash
    • Downloadlink: Git Bash
    • Während der Installation bei Adjusting your PATH environment den Punkt Use Git from the Windows Command Prompt auswählen (Voreinstellung) (damit kann Git Bash später automatisch über die normale Kommandozeile aufgerufen werden)
    • Andere Voreinstellungen können im Normalfall einfach übernommen werden
  2. Installation von GPSBabel
    • Downloadlink: GPSBabel
    • Installationspfad (zum Beispiel C:\Program Files (x86)\GPSBabel) zur PATH-Umgebungsvariable hinzufügen
  3. Installation von BC
    • Downloadlink: BC
    • Installationspfad (zum Beispiel C:\Program Files (x86)\GnuWin32\bin) zur PATH-Umgebungsvariable hinzufügen
  4. Versenden der generierten GPX-Dateien per Mail gewünscht? - Download von sendEmail
    • Downloadlink: sendEmail
    • Auf Festplatte entpacken (zum Beispiel nach C:\Pogram Files (x86)\sendEmail) und diesen Pfad zur PATH-Umgebungsvariable hinzufügen
    • Hinweis: funktioniert nicht mit allen E-Mail-Anbietern

Skript herunterladen

Im Benutzerverzeichnis des PCs (C:\Users\<Benutzername>\) einen Ordner namens oc_car erstellen und die beiden folgenden Dateien dort speichern:

  1. Download von JSON.sh
    • Downloadlink: JSON.sh (Ziel speichern unter)
    • Für Koordinatenabruf notwendig
  2. Git Bash (bash.exe) öffnen und JSON.sh ausführbar machen mittels
    chmod +x JSON.sh
  3. Download von oc_car.sh
    • Downloadlink: oc_car.sh (Ziel speichern unter)

Ausführung des Skriptes

 
Parameter
 
Fertig durchgelaufenes Skript
  1. Kommandozeile starten (cmd.exe)
  2. Mit cd oc_car in das Skriptverzeichnis wechseln
  3. Aufruf des Skriptes mit bash oc_car.sh (falls bereits eine GPX-Datei mit einer Route, z. B. route.gpx vorhanden ist, kann diese als Parameter übergeben werden: bash oc_car.sh route.gpx)
  4. Entsprechende Einstellungen tätigen und Route erzeugen lassen
  5. Beim ersten Skriptdurchlauf wird die Datei oc_car.conf erstellt, in der bei gewünschtem Mailversand die Serverdaten inkl. Passwort eingetragen werden müssen - danach Skript noch einmal durchlaufen lassen
  6. Am Ende erhältst Du eine Meldung über den Dateinamen der erstellten GPX-Datei - diese befindet sich, zusammen mit der berechneten Route und der bereits genannten Konfigurationsdatei, im Ordner oc_car