Trackables zu finden ist eigentlich immer eine schöne Sache. Sei es in einem Cache, sei es auf einem Event - Trackables haben fast immer eine Geschichte zu erzählen. Kurz, wir mögen Trackables.

Trackables in GSAK zu loggen ist sehr einfach. Sie zu verwalten eigentlich auch, aber der Weg dorthin ist ein wenig steinig, weil Groundspeak (“GS”) seine Benutzerschnittstelle (Advanced Programming Interface, “API”) nur teilweise sinnvoll gestaltet hat. Statt also GSAK sagen zu können: “Hol’ mir bitte einmal alle meine bereits geloggten Trackables und pack’ sie in eine Datenbank, damit ich dann mit ihnen weiterarbeiten kann”, muss man einen Umweg gehen. Der Umweg ist in dieser Anleitung beschrieben.

Ziel dieses Dokuments ist es, Euch einen einfachen und effizienten Weg zu zeigen, wie man bereits geloggte Trackables in GSAK importiert und dann mit ihnen weiterarbeitet. Eine Einführung in GSAK findet Ihr auch in unseren Präsentationsfolien.

Im Ergebnis soll Euch folgendes gelingen:

Alle von Euch jemals gefundenen oder besessenen Trackables sind in einer Datenbank “My Trackables”.
Die Statistikmakros BadgeGen und FindStatGen nutzen diese Datenbank zur automatisierten Auswertung.
Eure eigenen Trackables können automatisiert aktualisiert werden, wenn Ihr sie bewegt.
Neue Trackables könnt Ihr effizient in die Datenbank einpflegen.

Hierbei gehen wir von folgenden Annahmen aus, die zwingend erforderlich sind:

Ihr verfügt über eine installierte und lauffähige, aktuelle Version von GSAK.
Ihr wisst, wie man Makros in GSAK installiert und ausführt.
Ihr wisst, wie man ein Add-On zu Firefox oder Chrome hinzufügt.
Ihr verfügt über ein Premium-Account bei GroundSpeak.

Das ist alles. Im Menü “Datei” oben links könnt Ihr diese Anleitung als PDF, Word oder Open Document herunterladen. Ihr könnt dieses Dokument hier auch jederzeit kommentieren - wir freuen uns über Verbesserungsvorschläge und Fehlerkorrekturen.

Wir hoffen, Ihr habt so viel Spaß beim Lesen wie wir beim Schreiben!

Und damit genug der Vorrede!

2 Vorbereitung

2.1 Für diese Anleitung benötigte Makros

In diesem Dokument setzen wir den Einsatz einiger Makros voraus. Wir gehen davon aus, dass Ihr wisst, wie man ein Makro installiert. Falls nicht, ist das auch nicht schlimm: Ihr ladet die Dateien aus den nun folgenden Links herunter, startet sie mit einem Doppelklick und sagt in dem sich anschließenden Dialog in GSAK, dass Ihr sie installieren wollt. Diesen Vorgang wiederholt Ihr für jedes der folgenden Makros:

AddTrackablesAPI - Trackables via API in die Datenbank kopieren, loggen, oder ihre Daten auffrischen
TrackableMovedApi - Daten von fremden Trackables in der Datenbank auffrischen
TrackableMovedSummary (optional, falls Ihr diese Daten in Eure Statistik einbinden wollt)
TrackableOwnedAPI - Daten von eigenen Trackables in der Datenbank auffrischen
TrackableOwnedSummary (optional, falls Ihr diese Daten in Eure Statistik einbinden wollt)

2.2 Für diese Anleitung benötigte GSAK-Datenbanken

Wir nutzen in dieser Anleitung eine eigene Datenbank für die Verwaltung aller eigenen und gefundenen Trackables. Diese Datenbank muss “My Trackables” heißen, weil die Makros diesen Namen erwarten. Ihr könnt eine Datenbank mit Datenbank ➙ Neu (STRG+n) anlegen.

2.4 Weiterführende Lektüre und Fragen

Wir empfehlen das GSAK-Forum (en,de) und das GSAK-Unterforum im Geoclub (de).

3 Bereits geloggte Trackables in GSAK einpflegen

Die Groundspeak-API erlaubt es bedauerlicherweise nicht, die TB-Codes Eurer bereits geloggten Trackables bequem aus GSAK zu ziehen. Ihr müsst deshalb einen Umweg nehmen. Dieser setzt die Installation eines Add-Ons für Euren Browser und eines User Scripts für dieses Add-On voraus. Das Userscript wird benötigt, um die TB-Codes auf GS einzusammeln.

3.1 Greasemonkey/Tampermonkey installieren

Greasemonkey für Firefox findet Ihr hier.
Tampermonkey für Google Chrome findet Ihr hier.

3.2 collectTB-Codes installieren

Zunächst müsst Ihr also die neue Datenbank “My Trackables” mit Euren bereits auf GS geloggten Trackables füllen. Hierfür benötigt Ihr das Userscript collectTB-Codes (gibt es hier). Abhängig von der Menge der bereits auf GS geloggten Trackables bieten sich weiterhin eine Gamer-Maus, ein Katzenfell für Euren Maus-Zeigefinger und viel Zeit an.

Installiert zunächst das Userscript:

Geht dann auf GS in Eure Liste geloggter Trackables:

Öffnet jetzt jedes Link zu jedem Trackable. Am schnellsten geht das, indem Ihr die Trackables jeweils in einem neuen Tab im Hintergrund öffnet. So könnt Ihr die Liste der Trackables in halbwegs erträglicher Zeit abarbeiten. In Chrome ist der Standard-Shortcut dafür STRG+linke Maustaste; in Firefox ebenfalls STRG+linke Maustaste oder nur die mittlere Maustaste.

In den Tabs im Hintergrund werkelt ab jetzt das soeben installierte Userscript. Dessen Ausgabe seht Ihr in dem neuen Fenster rechts im Screenshot:

Wenn Ihr alle Eure Trackables einmal geöffnet habt, findet Ihr im zuletzt geöffneten Tab die Liste aller TB-Codes. Diese kopiert Ihr nun und fügt sie mit AddTrackablesAPI.gsk in die “My Trackables”-Datenbank ein. Wie, zeigen wir Euch im nächsten Schritt.

3.3 AddTrackablesAPI.gsk installieren

Dieses Makro erlaubt es Euch, Trackables schnell und einfach unter Nutzung des Groundspeak-API zu einer Datenbank hinzuzufügen. Zunächst müsst Ihr das Makro aber installieren. Ihr findet es hier.

Wenn Ihr es startet, seht Ihr den untenstehenden Bildschirm. Alle Funktionen im Detail zu erklären, würde den Rahmen dieser Kurzanleitung sprengen. Sie sind auf gsak.net hervorragend dokumentiert (eine Computerübersetzung mit Google Translate findet Ihr hier).

Anpassen müsst Ihr die Trackable-Datenbank (“Select the database to add the trackables to”) sowie Euren Benutzernamen (“Owner Name”) und Eure Benutzer-ID (“Owner ID”). Wenn Ihr jetzt die TB-Codes aus dem vorigen Schritt in das Feld “Manually enter TB codes…” eingebt und “OK” drückt, werden die Trackables in die “My Trackables”-Datenbank importiert.

4 Eure eigenen Trackables importieren

Zunächst müsst Ihr Eure eigenen Trackables in die Datenbank importieren. Auch bei diesem Schritt hilft das AddTrackablesAPI-Makro. Klickt im Menü auf “Fetch”:

Klickt dann auf “Owned trackables”:

Das Makro bezieht über die API die TB-Codes Eurer Trackables und füllt damit das Import-Feld des Makros aus. Ihr klickt “OK”, wartet - und auch Eure eigenen Trackables sind in der Datenbank.

Und damit wären wir dann erst einmal fertig. Alle Trackables sind in der Datenbank. Jetzt geht es daran, sie zu verwalten...

5. Trackables mit GSAK verwalten

Es gibt vier weitere Makros, mit denen Ihr Eure Trackables verwalten könnt.

Zwei Makros, mit denen Ihr die Daten (Logs usw.) geloggter oder eigener Trackables über die API aktualisieren könnt:

Zwei Makros, mit denen Ihr eine statistische Zusammenfassung beider Trackable-Typen erstellen könnt, um sie anschließend in FindStatGen weiterzuverwenden:

Wir selbst setzen nur das Makro-Paar “Owned” für unsere eigenen Trackables ein. Die anderen beiden Makros (“Moved”) sind von eher akademischem Interesse.

5.1 Das TrackableOwnedAPI-Makro

Zunächst müsst Ihr dem Makro verraten, in welcher Datenbank es suchen soll, und dass es diese nutzen soll (“Use Existing”). Denn Ihr habt ja schon eine Datenbank angelegt. Außerdem müsst Ihr noch eine Benutzer-ID einfügen. Wenn Ihr sicher seid, dass Eure Werte stimmen und das Makro funktioniert, könnt Ihr den Dialog unterbinden, indem Ihr den Haken bei “Open this Dialog…” entfernt.

Lasst anschließend das Makro durchlaufen. Das kann eine Weile dauern, falls Ihr viele Trackables mit vielen Logs habt...

5.2 Das TrackableOwnedSummary-Makro

Dieses Makro erzeugt witzige Statistiken, die Ihr in FindStatGen einbinden könnt. Startet es zunächst und passt die fehlenden Werte an. Wie oben sind das a) die Datenbank und b) Eure Benutzer-ID sowie c) Eure Heimatkoordinaten (“Choose Home Location”). Lasst das Makro dann durchlaufen.

Das Ergebnis kann dann z.B. so aussehen:

Wie Ihr die von diesem Makro erzeugten Daten in FindStatGen einbindet, haben wir hier erklärt.

Der hierfür notwendige Code könnte z.B. so aussehen:

<notitle/>
<subhead>Trackables Owned Summary</subhead><file>TrackableOwnedSummary.html</file>
<subhead>Trackables Owned Map</subhead><file>TrackableOwnedMapURL.html</file>

6 Zusammenfassung

Wenn Ihr dieser Anleitung Schritt für Schritt gefolgt seid, dann solltet Ihr jetzt folgendes tun können:

Alle von Euch jemals gefundenen oder besessenen Trackables sind in einer Datenbank “My Trackables”.
BadgeGen und FindStatGen nutzen diese Datenbank zur automatisierten Auswertung für Eure Statistiken.
Eure eigenen Trackables können automatisiert aktualisiert werden, wenn Ihr sie bewegt.
Neue Trackables könnt Ihr effizient in die Datenbank einpflegen.

Wir hoffen, dass wir Euch das Loggen und Verwalten von Trackables etwas erleichtert haben. Falls Euch diese Anleitung gefällt, würden wir uns freuen, wenn Ihr sie verbessert und erweitert. Auf der nächsten Seite findet Ihr die Lizenz, unter der das Dokument steht. Ihr könnt damit eigentlich alles machen - außer Geld zu verdienen.

In diesem Sinne: Geht raus und sucht Dosen!

Anhang

A1 Danksagung

Wir möchten den folgenden Geocachern herzlichst für Ihre Unterstützung, Ideen und Korrekturvorschläge danken:

A2 Copyright

Diese Anleitung wurde von RNKBerlin erstellt. Wir stellen sie unter der umseitig genannten Lizenz zu Eurer Verfügung. Fühlt Euch frei sie zu verändern, zu ergänzen oder zu korrigieren.

Im Gegenzug würden wir uns freuen, wenn der Ursprung der Anleitung erwähnt wird und Ihr uns eine Kopie Eurer Änderungen zukommen lassen könntet. In der Summe entsteht so vielleicht irgendwann eine umfassende Anleitung zum Thema.

Ihr erreicht uns unter robin-gsak@wampenschleifer.de.

A3 Lizenz

Dies ist eine alltagssprachliche Zusammenfassung der Lizenz (die diese nicht ersetzt).

Haftungsbeschränkung

Sie dürfen:

Teilen — das Material in jedwedem Format oder Medium vervielfältigen und weiterverbreiten
Bearbeiten — das Material remixen, verändern und darauf aufbauen

Der Lizenzgeber kann diese Freiheiten nicht widerrufen solange Sie sich an die Lizenzbedingungen halten.

Unter folgenden Bedingungen:

Namensnennung — Sie müssen die Urheberschaft ausreichend deutlich benennen, einen Link zur Lizenz beifügen und angeben, ob Änderungen vorgenommen wurden. Diese Angaben dürfen in jeder angemessenen Art und Weise gemacht werden, allerdings nicht so, dass der Eindruck entsteht, der Lizenzgeber unterstütze gerade Sie oder Ihre Nutzung des Werks besonders.
Nicht kommerziell — Sie dürfen das Material nicht für kommerzielle Zwecke nutzen.
Weitergabe unter gleichen Bedingungen — Wenn Sie das Material remixen, verändern oder anderweitig direkt darauf aufbauen, dürfen Sie Ihre Beiträge nur unter derselben Lizenz wie das Original verbreiten.
No additional restrictions — Sie dürfen keine zusätzlichen Klauseln oder technische Verfahren einsetzen, die anderen rechtlich irgendetwas untersagen, was die Lizenz erlaubt.

Hinweise:

Sie müssen sich nicht an diese Lizenz halten hinsichtlich solcher Teile des Materials, die gemeinfrei sind, oder soweit Ihre Nutzungshandlungen durch Ausnahmen und Schranken des Urheberrechts gedeckt sind.

Es werden keine Garantien gegeben und auch keine Gewähr geleistet. Die Lizenz verschafft Ihnen möglicherweise nicht alle Erlaubnisse, die Sie für die jeweilige Nutzung brauchen. Es können beispielsweise andere Rechte wie Persönlichkeits- und Datenschutzrechte zu beachten sein, die Ihre Nutzung des Materials entsprechend beschränken.

RNKBerlin | GSAK-Anleitungen | Version 20170401-0125