Caches entlang einer Route: Unterschied zwischen den Versionen

Formatierung überarbeitet; Windows-Anleitung korrigiert, da Anpassungsskript nicht mehr verfügbar und nicht unbedingt notwendig
Keine Bearbeitungszusammenfassung
(Formatierung überarbeitet; Windows-Anleitung korrigiert, da Anpassungsskript nicht mehr verfügbar und nicht unbedingt notwendig)
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 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.


[http://www.opencaching.de/viewprofile.php?userid=234947 FriedrichFröbel] hat ein kleines Programm entwickelt, welches das Script auch unter Windows lauffähig macht. Er kümmert sich auch um den Einbau neuer Funktionen und die Behebung eventuell vorhandener Fehler.
[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.


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 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.


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 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.


Folgende Angaben sollten für Start / Ziel funktionieren
Folgende Angaben sollten für Start / Ziel funktionieren:
* Koordinaten im Format lat,lng ohne Leerzeichen, auf . und , achten -> 48.321,9.123
 
* Koordinaten im Format <code>lat,lng</code> ohne Leerzeichen, auf <code>.</code> und <code>,</code> achten -> <code>48.321,9.123</code>
* Ortsnamen
* Ortsnamen
* Straße, Ortsnamen
* Straße, Ortsnamen
Zeile 15: Zeile 16:


== Die Installation unter Linux ==
== Die Installation unter Linux ==
[[Datei:Oc car.png|200px|thumb|right|Fertig durchgelaufenes Skript]]
[[Datei:Oc car.png|200px|thumb|right|Fertig durchgelaufenes Skript]]
Terminal starten, Shortcut: Strg + Alt + T, das Terminal wird im home-Verzeichnis geöffnet


Lege ein neues Verzeichnis an mit<br>
# Terminal starten, Shortcut: Strg + Alt + T, das Terminal wird im Home-Verzeichnis geöffnet.
<code>mkdir oc_car</code>
# Lege ein neues Verzeichnis an mit
#: <pre>mkdir oc_car</pre>
# Wechseln in das Verzeichnis mit
#: <pre>cd oc_car</pre>
# Pakete (unter Debian Linux und Derivaten) installieren - soweit nötig - mit
#: <pre>sudo apt-get install gpsbabel</pre>
#: <pre>sudo apt-get install bc</pre>
#: <pre>sudo apt-get install sendemail</pre>
#: <pre>sudo apt-get install curl</pre>
# Script herunterladen mit
#: <pre>curl https://raw.githubusercontent.com/friedrichfroebel/oc_car/master/oc_car_0.4.sh > oc_car.sh</pre>
# Script zur Verarbeitung der Koordinaten herunterladen mit
#: <pre>curl https://raw.githubusercontent.com/dominictarr/JSON.sh/master/JSON.sh > JSON.sh</pre>
# Scripte ausführbar machen mit
#: <pre>sudo chmod 744 oc_car.sh</pre>
#: <pre>sudo chmod 744 JSON.sh</pre>
# Ausführen mit
#: <pre>./oc_car.sh</pre>


Wechseln in das Verzeichnis mit<br>
Nach dem ersten Durchlauf wird die Datei <code>oc_car.conf</code> erstellt. Hier bitte die E-Mail-Daten hinterlegen, wenn ein E-Mail-Versand erwünscht ist.
<code>cd oc_car</code>


Pakete (unter Debian Linux und Derivaten) installieren - soweit nötig - mit <br>
== Die Installation unter Windows ==
<code>sudo apt-get install gpsbabel bc</code>  <br>
<code>sudo apt-get install sendemail</code> <br>
<code>sudo apt-get install curl</code>


Script herunterladen mit<br>
=== Vorbereitungen/Voraussetzungen ===
<code>curl https://raw.githubusercontent.com/friedrichfroebel/oc_car/master/oc_car_0.4.sh > oc_car.sh</code>


Script zur Verarbeitung der Koordinaten herunterladen mit<br>
# Installation von '''Git Bash'''
<code>curl https://raw.githubusercontent.com/dominictarr/JSON.sh/master/JSON.sh > JSON.sh</code>
#* Downloadlink: [http://git-scm.com/download/win 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
# Installation von '''GPSBabel'''
#* Downloadlink: [http://www.gpsbabel.org/download.html GPSBabel]
#* Installationspfad (zum Beispiel <code>C:\Program Files (x86)\GPSBabel</code>) zur <code>PATH</code>-Umgebungsvariable hinzufügen
# Installation von '''BC'''
#* Downloadlink: [http://gnuwin32.sourceforge.net/downlinks/bc.php BC]
#* Installationspfad (zum Beispiel <code>C:\Program Files (x86)\GnuWin32\bin</code>) zur <code>PATH</code>-Umgebungsvariable hinzufügen
# Versenden der generierten GPX-Dateien per Mail gewünscht? - Download von '''sendEmail'''
#* Downloadlink: [http://caspian.dotconf.net/menu/Software/SendEmail/sendEmail-v156.zip sendEmail]
#* Auf Festplatte entpacken
#* 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''


Scripte ausführbar machen mit<br>
=== Skript herunterladen ===
<code>Sudo chmod 744 oc_car.sh</code><br>
<code>Sudo chmod 744 JSON.sh</code>


Ausführen mit<br>
Im Benutzerverzeichnis des PCs (<code>C:\Users\<Benutzername>\<code/>) einen Ordner namens <code>oc_car</code> erstellen und die beiden folgenden Dateien dort speichern:
<code>./oc_car.sh</code>


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.<br>
# Download von '''JSON.sh'''
<code>oc_car.conf</code>
#* Downloadlink: [https://raw.githubusercontent.com/dominictarr/JSON.sh/master/JSON.sh JSON.sh] (''Ziel speichern unter'')
#* Für Koordinatenabruf notwendig
# 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'')
#* Im gleichen Verzeichnis wie <code>JSON.sh</code> als <code>oc_car.sh</code> speichern.


== Die Installation unter Windows ==
=== Ausführung des Skriptes ===
=== Vorbereitungen/Voraussetzungen ===
* Installation von '''Git Bash'''
** Downloadlink: [http://git-scm.com/download/win 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
* Installation von '''GPSBabel'''
** Downloadlink: [http://www.gpsbabel.org/download.html GPSBabel]
** Installationspfad merken, da später benötigt!
* Installation von '''BC'''
** Downloadlink: [http://gnuwin32.sourceforge.net/downlinks/bc.php BC]
** Installationspfad merken, da später benötigt!
* Versenden der generierten GPX-Dateien per Mail gewünscht? (beim Generieren des Skriptes entscheidbar) - Download von '''sendEmail'''
** Downloadlink: [http://caspian.dotconf.net/menu/Software/SendEmail/sendEmail-v156.zip sendEmail]
** auf Festplatte entpacken und Pfad merken!
** ''Hinweis: funktioniert nicht mit allen E-Mail-Anbietern''


=== Erstellen des Skriptes ===
[[Datei:Oc car-Windows erstellen.png|200px|thumb|right|Skript für Windows anpassen]]
* Download von '''JSON.sh'''
** Downloadlink: [https://raw.githubusercontent.com/dominictarr/JSON.sh/master/JSON.sh JSON.sh] (''Ziel speichern unter'')
** für Koordinatenabruf notwendig
* Download der '''occar_W.exe'''
** Downloadlink: [https://github.com/FriedrichFroebel/oc_car-Windows/blob/master/occar_W.exe occar_W.exe]
** im gleichen Verzeichnis wie die '''JSON.sh'''-Datei speichern
* in den Ordner mit diesen beiden Dateien wechseln
* '''occar_W.exe''' mit Doppelklick starten
* Programmpfade angeben (Eingaben werden im Normalfall mit der '''''Enter'''''-Taste bestätigt)
** Frage nach Aktivierung des E-Mail-Versandes mit '''''J''''' oder '''''N''''' beantworten - evtl. Pfad zur '''sendEmail.exe'''-Datei eingeben
** Pfad für '''GPSBabel''' eingeben (endet im Normalfall auf '''''GPSBabel\gpsbabel.exe''''')
** Pfad für '''BC''' eingeben (endet im Normalfall auf '''''GnuWin32\bin\bc.exe''''')
** ''Das Vorhandensein der angegebenen Dateien wird geprüft. Bei Fehlern erscheint die entsprechende Abfrage erneut. Die aktuellen Windowsversionen zeigen im Explorer zwar den Ordnernamen'' '''''Programme''''' ''an, sind aber eigentlich unter'' '''''Program Files''''' ''zu finden.''
* sobald alle Programmpfade angegeben worden sind, befindet sich Deine persönliche Skriptdatei in dem Ordner, in dem sich auch die '''occar_W.exe'''-Datei befindet
* erstelle im Benutzerverzeichnis Deines PCs ('''''C:\Users\<Benutzername>\''''') einen Ordner mit der Bezeichnung '''oc_car''' und verschiebe die Datei '''oc_car.sh''' und '''JSON.sh''' in diesen
=== Ausführung des Skriptes ===
[[Datei:Oc car-Windows Parameter.png|200px|thumb|right|Parameter]]
[[Datei:Oc car-Windows Parameter.png|200px|thumb|right|Parameter]]
[[Datei:Oc car-Windows Abfrage.png|200px|thumb|right|Fertig durchgelaufenes Skript]]
[[Datei:Oc car-Windows Abfrage.png|200px|thumb|right|Fertig durchgelaufenes Skript]]
* Kommandozeile starten ('''''cmd.exe''''')
 
* mit <code>cd oc_car</code> in das Skriptverzeichnis wechseln
# Kommandozeile starten (<code>cmd.exe</code>)
* Aufruf des Skriptes mit <code>oc_car.sh</code> (falls bereits eine GPX-Datei mit einer Route, z. B. ''route.gpx'' vorhanden ist, kann diese als Parameter übergeben werden: <code>oc_car.sh route.gpx</code>)
# Mit <code>cd oc_car</code> in das Skriptverzeichnis wechseln
* entsprechende Einstellungen tätigen und Route erzeugen lassen
# Aufruf des Skriptes mit <code>bash oc_car.sh</code> (falls bereits eine GPX-Datei mit einer Route, z. B. <code>route.gpx</code> vorhanden ist, kann diese als Parameter übergeben werden: <code>bash oc_car.sh route.gpx</code>)
* 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
# Entsprechende Einstellungen tätigen und Route erzeugen lassen
* ''Hinweis: Umlaute in Start und Ziel werden umgewandelt, genauso wie Leerzeichen''
# Beim ersten Skriptdurchlauf wird die Datei <code>oc_car.conf</code> erstellt, in der bei gewünschtem Mailversand die Serverdaten inkl. Passwort eingetragen werden müssen - danach Skript noch einmal durchlaufen lassen
* 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'''
# 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 <code>oc_car</code>


[[Kategorie:Geocaching-Software]]
[[Kategorie:Geocaching-Software]]
[[Kategorie:Opencaching]]
[[Kategorie:Opencaching]]