Readme: garminmap.xml


Inhaltsverzeichnis

Beispiel: pro Cachetyp ein Symbol
Beispiel: verknüpfte Bedingungen
Beispiel: OZI Export
Beispiel: Garmin POI (GPI)
Garmin POI Loader
GPI Dateien erzeugen
Anhang
Cachetypen
Cachegrößen

Zusammenfassung

Mit Hilfe der Datei garminmap.xml wird für den Export von GPX- und OZI-Wegpunktdateien festgelegt wie die Wegpunkte im jeweiligen Programm dargestellt werden. Darüber hinaus kann festgelegt werden welche Kategorien und Symbole beim Erzeugen von Custom POI für Garmin Handheld Geräte verwendet werden. Die Datei muss im selben Verzeichnis liegen wie die Datei prefs.xml.

Dieses Dokument beschreibt nicht die eigentliche Installation der Custom Symbols auf dem Handheld oder in Mapsource.

In der Datei Garmin User Symbols.zip findest du einige Beispiele, die im Folgenden kurz erklärt werden sollen.

Beispiel: pro Cachetyp ein Symbol

Im diesem Beispiel wird einfach jedem Cachetyp ein eigenes Symbol zugeordnet

<?xml version="1.0" encoding="ISO-8859-1"?>
<iconmap>
<icon type="0" name="Custom 18" />
<icon type="2" name="Custom 0" />
<icon type="3" name="Custom 1" />
<icon type="4" name="Custom 6" />
<icon type="5" name="Custom 3" />
<icon type="6" name="Custom 4" />
<icon type="8" name="Custom 2" />
<icon type="11" name="Custom 7" />
<icon type="12" name="Custom 10" />
<icon type="13" name="Custom 5" />
<icon type="50" name="Parking Area" />
<icon type="51" name="Custom 11" />
<icon type="52" name="Custom 12" />
<icon type="53" name="Custom 16" />
<icon type="54" name="Trail Head" />
<icon type="55" name="Custom 14" />
<icon type="100" name="Custom 4" />
<icon type="101" name="Custom 17" />
<icon type="102" name="Custom 18" />
<icon type="103" name="Custom 20" />
<icon type="104" name="Custom 8" />
</iconmap>

Die Datei garminmap.xml beginnt immer mit

<?xml version="1.0" encoding="ISO-8859-1"?>
<iconmap>

und endet mit

</iconmap>

Jede einzelne Zeile beginnt mit <icon und endet mit />. Bitte das Leerzeichen nicht vergessen,

Innerhalb der Zeile finden sich dann Bedingungen und Anweisungen.

In unserem Beispiel ist type="2" eine Bedingung, die auf alle Traditional Caches zutrifft und name="Custom 0" die Anweisung die ausgeführt wird, wenn die Bedingung erfüllt ist. In diesem Fall wird auf einem Garmin Handheld oder in Mapsource das Benutzerdefinierte Symbol 0 angezeigt. Eine Liste aller Cachetypen findest du im Anhang.

Wie die Zeile

<icon type="50" name="Parking Area" />

zeiget muss man sich bei den anzuzeigenden Symbolen nicht auf die Benutzerdefinierten beschränken, sondern kann auch die in jedem Garmin Handheld fest eingebauten Symbole benutzen. Auf diese Weise können auch Benutzer von Geräten die das Anlegen von Benutzerdefinierten Symbolen nicht unterstützen von der Garminmap profitieren und zumindest unterschiedliche Symbole darstellen lassen.

Beispiel: verknüpfte Bedingungen

Neben der einfach Zuweisung aus dem ersten Beispiel lassen sich mit der garminmap.xml auch komplexere Bedingungen für die Zuweisung eines Symbols erstellen. Dabei sind folgende Bedingungen möglich und beliebig kombinierbar:

  • type= Typ des Caches. Für mögliche Werte siehe Liste.

  • size= Größe des Cachebehälters. Für mögliche Werte siehe Liste

  • terrain= 10, 15, 20, 25, 30, 35, 40, 45 oder 50. Custom und Additional Waypoints haben keine Geländebewertung

  • difficulty= 10, 15, 20, 25, 30, 35, 40, 45 oder 50. Custom und Additional Waypoints haben keine Schwierugkeit

  • found= 1 (gefunden) oder 0 (nicht gefunden). Nicht verwechseln mit status

  • status= Inhalt des Statusfeldes im Detailspanel. Es wird nur gegen den Anfang des Feldes geprüft. status="Nacht" findet als Nachtcache und Nachtisch!

Wichtig dabei ist, dass die Werte der Bedingungen immer mit doppelten Anfürungszeichen (") umschlossen werden.

<icon type="2" terrain="50" name="XXXX" />

weist allen caches vom Typ 2 (Traditional) und der Geländewertung 50 (5) das Symbol mit dem Namen zu.

Weil man häufig auch für Gelände 4.5 eine erweitere Ausrüstung braucht, könnte man das auch wie folgt ergämzen

<icon type="2" terrain="50" name="XXXX" />
<icon type="2" terrain="45" name="XXXX" />

Damit alle anderen Tradis auch ein Symbol bekommen, könnte die komplette Sequenz für Tradis dann so aussehen:

<icon type="2" terrain="50" name="XXXX" />
<icon type="2" terrain="45" name="XXXX" />
<icon type="2" name="Custom 0" />

Alle Traids mit Gelände 5 oder 4.5 bekommen das Symbol XXXX alle übrigen Tradis das Symbol Custom 0. Du kannst in einer Reihe beliebig viele Bedingungen benutzen. Die Reihen werden dabei in der Reihenfolge abgearbeitet in der sie in der datei stehen. Die Reihen mit komplexeren Bedingungen sollten also immer vor den einfachen Regeln stehen. Bei einem Eintrag von

<icon type="2" name="Custom 0" />
<icon type="2" terrain="50" name="XXXX" />
<icon type="2" terrain="45" name="XXXX" />

würden die speziellen Regeln für das Gelände nie benutzt werden, da alle Tradis bereits von der ersten Regel erfasst würden.

Beispiel: OZI Export

Die Datei garminmap.xml kann auch zusammen mit dem OZI Export benutzt werden. In dem Fall heisst die Anweisung aber nicht name="" sondern ozicolor="". Dabei steht ozicolor für die verwendete Hintergrundfarbe bei der Darstellung. Die Vordergrundfarbe ist immer Schwarz.

Ein Traditional Cache könnte durch folgende Regel dargestellt werden:

<icon type="2" ozicolor="65280" />

Ein Traditional würde also in Grün dargestellt, denn alle Farbangaben sind die Dezimalschreibweisen der eigentlich hexadezimalen RGB Farben. 65280 entspricht dabei dem Farbcode 00FF00.

Im Internet findest du zahlreiche RGB Farbtabellen aus denen du dir die Farben mit denen deine Wegpunkte dargestellt werden sollen aussuchen kannst. Mit dem Taschenrechner, den dein Betriebssystem mitliefert, können die dort angegeben Hexadezimalwerte meist bequem in das dezimale Format umgerechnet werden. Versuche Farben zu verwenden, die sich gut unterscheiden lassen.

Genauso wie Bedingungen verknüpft werden können, können auch Anweisungen verknüpft werden. Solltest du also eine angepasste Darstellung für Garmin und Ozi haben wollen, benötigst du nicht zwei verschiedene Dateien, sondern kannst beides in einer einzigen Datei festlegen. Für den Traditional Cache aus unserem Beispiel könnte das dann so aussehen:

<icon type="2" name="Custom 0" ozicolor="65280" />

Beispiel: Garmin POI (GPI)

Zuammen mit dem experimentellen GPX Exporter kann die garminmap.xml auch verwendet werden um Einzeldateien für den Gramin POI Loader oder diekt GPI dateien für die Verwendung auf dem Garmin Handheld zu erzeugen. Dazu wurde die Anweisung poiid="" eingeführt.

Wichtig

Nicht alle Garmin Handhelds unterstützen die Verwendung von Custom Points of Interest. Bitte schau im Handbuch deines Gerätes nach, ob die Funktion unterstützt wird bevor du sie benutzt.

Bei der poiid handelt es sich um einen Freitext der von dir individuell festgelegt werden kann. Da einige Garmin Handhelds jedoch Schwierigkeiten bei der Darstellung von Sonderzeichen haben, solltest du dich bei der Vergabe der ID auf die Zeichen A-z, a-z, 0-9, sowie - und _ beschränken.

<icon type="2" poiid="Traditional" />

könnte also eine Regel sein, die festlegt wie während eines POI Exports Traditional Caches behandelt werden. Natürlich lassen sich auch hier wieder die verschiednen Anweisungen kombinieren, so daß eine solche Regel auch so aussehen könnte:

<icon type="2" poiid="Traditional" ozicolor="65280" name="Custom 0" />

Beim Export wird der vergebenen ID noch ein Prefix vorangestellt, welche du im Exportdialog vergibst. Prefix und piid sollten gemeinsam auf das Display deines Handhelds passen.

Garmin POI Loader

Sofern du den Garmin POI Loader benutzen möchtest um deine Wegpunkte später auf den Handheld zu laden, musst du nichts weiter tun. Der Exporter wird im angegebenen Verzeichnis Dateien mit dem Namen Prefix-PoiId.gpx erzuegen, die du weiterverarbeiten kannst.

GPI Dateien erzeugen

Garmin GPI Dateien enthalten neben den Wegpunktinformationen immer auch eine Grafik mit der der Wegpunkt auf dem Bildschirm dargestellt wird. Damit eine korrekte GPI Datei erzeugt werden kann, muss in dem Verzeichnis in dem die garminmap.xml liegt auch noch eine Datei mit dem Namen GarminPOI.zip existieren. In dieser Datei muss sich zu jeder von dir vergebenen poiid eine Datei mit dem Namen poiid.bmp befinden. Lautet eine deiner Anweisungen poiid="Traditional" muss sich in der GarminPOI.zip eine Traditional.bmp befinden.

Anhang

Cachetypen

Cachtypen werden innerhalb der Bedingungen durch einen Zahlenwert aus der folgenden Tabelle repräsentiert

0 Custom
2 Traditional
3 Multicache
4 Virtual Cache
5 Letterbox
6 Event Cache
8 Unknown / Mystery Cache
11 Webcam Cache
12 Locationless (Reverse) Cache
13 CITO Event
100 Mega Event
101 WhereIGo cache
102 Project Ape Cache
103 Adventure Maze Exhibit
104 Earthcache
50 Additional Waypoint Parking
51 Additional Waypoint Stage of a Multicache
52 Additional Waypoint Question to Answer
53 Additional Waypoint Final
54 Additional Waypoint Trailhead
55 Additional Waypoint Reference

Cachegrößen

Cachegrößen werden innerhalb der Bedingungen durch einen Buchstaben aus der folgenden Tabelle repräsentiert. Ob groß oder klein geschreiben spielt dabei keine Rolle.

m Micro
s Small
r Regular
l Large
v Very Large
n Not Chosen / Other / Virtual / None