Caches entlang einer Route: Unterschied zwischen den Versionen

Aus Opencaching-Wiki
Zur Navigation springen Zur Suche springen
(schließenden Tag korrigiert)
K (bessere Formulierung)
 
(3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
[[Datei:Oc car1.png|200px|thumb|right|Parameter]]Für Linux gibt es ein Script, mit dem eine [[GPX-Datei]] erzeugt werden kann, die alle Caches entlang einer [[Route]] beinhaltet. Das Script wurde durch [http://www.opencaching.de/viewprofile.php?userid=214033 ka_be] entwickelt und im [http://forum.opencaching.de/index.php?topic=3784.0 Opencaching-Forum] zur Verfügung gestellt.
[[Datei:Oc car1.png|200px|thumb|right|Parameter]]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 [http://www.opencaching.de/viewprofile.php?userid=214033 ka_be] entwickelt und im [http://forum.opencaching.de/index.php?topic=3784.0 Opencaching-Forum] zur Verfügung gestellt.


[http://www.opencaching.de/viewprofile.php?userid=234947 FriedrichFröbel] hat eine [https://github.com/FriedrichFroebel/oc_car-gui Version mit grafischer Oberfläche] auf Basis von Java entwickelt. Er kümmert sich auch um den Einbau neuer Funktionen und die Behebung eventuell vorhandener Fehler in das Bash-Script.
[http://www.opencaching.de/viewprofile.php?userid=234947 FriedrichFröbel] hat eine [https://github.com/FriedrichFroebel/oc_car-gui 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 Script sucht sich entweder selbst die [[Route]] oder es wird mit einer GPX-Datei aufgerufen, die die geplante Route enthält – diese kann bspw. bei [http://openrouteservice.org 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.
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 [http://openrouteservice.org 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 Script funktioniert, muss [[GPSBabel]] installiert sein, es wird für den E-Mail Versand '''SendEmail''', zum Skript-Download '''curl''' benötigt. Gestartet wird das Script dann im Terminal, wobei man diverse Parameter angeben muss/kann, wie Benutzernamen, Start, Ziel.
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:
Folgende Angaben sollten für Start/Ziel funktionieren:
Zeile 13: Zeile 13:
* Straße, Ortsnamen
* Straße, Ortsnamen


Das Script ruft dann die erforderlichen Daten ab und anschließend befindet sich im Scriptverzeichnis 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.
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 ==
== Die Installation unter Linux ==
Zeile 29: Zeile 29:
#: <pre>sudo apt-get install sendemail</pre>
#: <pre>sudo apt-get install sendemail</pre>
#: <pre>sudo apt-get install curl</pre>
#: <pre>sudo apt-get install curl</pre>
# Script herunterladen mit
# Skript herunterladen mit
#: <pre>curl https://raw.githubusercontent.com/friedrichfroebel/oc_car/master/oc_car_0.4.sh > oc_car.sh</pre>
#: <pre>curl https://raw.githubusercontent.com/FriedrichFroebel/oc_car/master/oc_car.sh > oc_car.sh</pre>
# Script zur Verarbeitung der Koordinaten herunterladen mit
# Skript zur Verarbeitung der (Start- und Ziel-)Koordinaten herunterladen mit
#: <pre>curl https://raw.githubusercontent.com/dominictarr/JSON.sh/master/JSON.sh > JSON.sh</pre>
#: <pre>curl https://raw.githubusercontent.com/dominictarr/JSON.sh/master/JSON.sh > JSON.sh</pre>
# Scripte ausführbar machen mit
# Skripte ausführbar machen mit
#: <pre>sudo chmod 744 oc_car.sh</pre>
#: <pre>sudo chmod 744 oc_car.sh</pre>
#: <pre>sudo chmod 744 JSON.sh</pre>
#: <pre>sudo chmod 744 JSON.sh</pre>
Zeile 57: Zeile 57:
# Versenden der generierten GPX-Dateien per Mail gewünscht? - Download von '''sendEmail'''
# Versenden der generierten GPX-Dateien per Mail gewünscht? - Download von '''sendEmail'''
#* Downloadlink: [http://caspian.dotconf.net/menu/Software/SendEmail/sendEmail-v156.zip sendEmail]
#* Downloadlink: [http://caspian.dotconf.net/menu/Software/SendEmail/sendEmail-v156.zip sendEmail]
#* Auf Festplatte entpacken
#* Auf Festplatte entpacken (zum Beispiel nach <code>C:\Pogram Files (x86)\sendEmail</code>) und diesen Pfad zur <code>PATH</code>-Umgebungsvariable hinzufügen
#* Installationspfad (zum Beispiel <code>C:\Program Files (x86)\GnuWin32\bin</code>) zur <code>PATH</code>-Umgebungsvariable hinzufügen
#* ''Hinweis: funktioniert nicht mit allen E-Mail-Anbietern''
#* ''Hinweis: funktioniert nicht mit allen E-Mail-Anbietern''


Zeile 68: Zeile 67:
#* Downloadlink: [https://raw.githubusercontent.com/dominictarr/JSON.sh/master/JSON.sh JSON.sh] (''Ziel speichern unter'')
#* Downloadlink: [https://raw.githubusercontent.com/dominictarr/JSON.sh/master/JSON.sh JSON.sh] (''Ziel speichern unter'')
#* Für Koordinatenabruf notwendig
#* Für Koordinatenabruf notwendig
# Git Bash (<code>bash.exe</code>) öffnen und <code>JSON.sh</code> ausführbar machen mittels
#: <pre>chmod +x JSON.sh</pre>
# Download von '''oc_car.sh'''
# Download von '''oc_car.sh'''
#* Downloadlink: [https://raw.githubusercontent.com/friedrichfroebel/oc_car/master/oc_car_0.4.sh oc_car_0.4.sh] (''Ziel speichern unter'')
#* Downloadlink: [https://raw.githubusercontent.com/FriedrichFroebel/oc_car/master/oc_car.sh oc_car.sh] (''Ziel speichern unter'')
#* Im gleichen Verzeichnis wie <code>JSON.sh</code> als <code>oc_car.sh</code> speichern.


=== Ausführung des Skriptes ===
=== Ausführung des Skriptes ===

Aktuelle Version vom 18. Mai 2020, 16:14 Uhr

Parameter

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.

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