NaviJoy

Anleitung zum Konfigurieren von POI auf Elektrobit StreetDirector
(Das ist der orginale Name der Software, die Medion, Falk, Kraemer Automotive und Blaupunkt lizensiert haben und unter den Namen Medion GoPal, Falk Navigator FN5/FN6, Kraemer Automotive RC-Win und Blaupunkt Lucca 5.3 anbieten)

Um POI unter Elektrobit StreetDirector einbinden zu können, benötigt man:

1. Eine Quelle für die POI, i.d.R. das Kartenmaterial des Anbieters oder sogenannte Overlays mit zusätzlichen POI.
2. Das Wissen, mit welchem sogenannten Code Agent (Auch Type ID genannt) man diese POI anspricht.
   Wenn Ihr selber Overlays erstellt, kennt Ihr deren ID logischerweise schon. Für fremde POI könnt Ihr in der ständig aktualisieren Type-ID-Liste nachsehen.
3. Eine Grafik, die den POI in der Kartenansicht markieren soll.
   Vielleicht werdet ihr ja in der Sammelecke für POI-Icons fündig oder postet Euer neu erstelltes POI-Icon dort.
4. Eine Änderung in der POI.PC, um die Navigationssoftware mit den neuen POI bekannt zu machen (Die sogenannte Type-Definition)
5. Eine Änderung in einer weiteren, von der verwendeten Variante des StreetDirector abhängigen, Konfigurationsdatei, wenn die POI auch bei einer Suche nach Sonderzielen auffindbar sein soll (Die Kategorie-Definition)
6. Bei GoPal 3.x und 4.x optional ein Icon für die Sammlung von Kategorie-Icons (Oft kurz als poi-cat, POI-Cat o.ä. bezeichnet), mit dem die POI als Suchtreffer der Sonderziel-Suche grafisch gekennzeichnet werden.
   Fertige POI-Kategorie-Grafiken gibt es hier. Wenn Du ein neues Symbol ergänzt, würden wir uns darüber freuen, wenn Du es ebenfalls dort postest!

Hinzufügen der Type-Definition (Alle)

Die Type-Definition sorgt dafür, daß der StreetDirector eine POI-Gruppe aus dem Kartenmaterial oder einem Overlay erkennt und in der Karte anzeigen kann.

Jede POI-Gruppe (z.B. Lidl, ALDI, Penny, Plus, etc. pp.) wird in einer eigenen solchen Definition definiert.

Die Definition sieht so aus:

<!-- Kommentar -->
<type id="tttt">
<bitmap position="kkkkk">ddddddddd,x,y,dx,dy,mx,my,r,g,b</bitmap>
<priority>ppp</priority>
<zoomlevel min="zmin" max="zmax" />
<code agent="PSF">aaaa</code>
</type>

An den blau markierten Stellen sind Werte einzusetzen.

Erklärung der einzutragenden Werte:

1. Zeile (Optional): Kommentar
   Vor der eigentlichen Definition kann ein Kommentar stehen, z.B. der Name der POIs, die über die nachfolgende POI-Definition definiert werden.
   Da es sich nur um einen Kommentar handelt, kann diese Zeile natürlich auch ersatzlos entfallen.
   Beispiel: <!-- Lidl NaviJoy -->
2. Zeile: Typ-Nummer (tttt) und Einleitung der Typdefinition
   Die Type-ID, die Ihr dieser POI-Gruppe zuweisen wollt. I.d.R. wird der Code Agent der POIs auch als ID benutzt, woher auch die synonyme Verwendung der beiden Begriffe herrührt.
   Jede Type-ID darf nur einmal genutzt werden. Wird das nicht eingehalten, nutzt das Programm die, die in der POI.PC zuerst auftaucht.
   Beispiel: <type id="9800">
3. Zeile: Grafikeinstellungen (position="kkkk",ddddddddd,x,y,dx,dy,mx,my,r,g,b)
   
   • kkkk = Position der Grafik innerhalb der poi_categories, die in der Ergebnisliste für diese POI angezeigt werden soll.
     Beispiel: Um das 66. Symbol von oben aus der poi-cat zu verwenden wird hier 66 eingetragen. Die Zählung beginnt bei 0!
     Diese Einstellung gibt es nur bei GoPal 3 und GoPal 4. Für die anderen OEM-Versionen entfällt dieser Wert mitsamt dem position="" drumherum. Es steht dann einfach nur <bitmap> am Anfang.
   • ddddddddd = Dateipfad zum in der Karte anzuzeigenden Symbol, relativ zum Programmverzeichnis der Navi-Software
     Das Programmverzeichnis ist i.d.R. \My Flash Disk\navigation. Werksseitig ist dort das Unterverzeichnis poi für die Kartensymbole vorgesehen und es spricht auch nichts dagegen, dieses - oder ein Unterverzeichnis davon - für eigene Symbole zu verwenden.
     Beispiel: poi\sr_Shopping_22x22.png
   • x,y = Offset von der linken, oberen Ecke bis zur Startposition der Grafik
     Gibt an, wo in der zuvor definierten Grafik sich das Symbol befindet, das für einen POI angezeigt werden soll.
     Anders als die meisten anderen Navigationssysteme kann der StreetDirector mehrere Symbole in einer einzigen Sammeldatei speichern und benötigt daher diese Angaben. Wird ein Einzelsymbol, also nur eine einzige Grafik in einer Datei, verwendet, ist hier 0,0 einzutragen.
     Beispiel: Das Symbol beginnt beim 66. Pixel von links und beim 22. Pixel von oben, dann ist hier 66,22 einzutragen. Auch hier beginnt die Zählung bei 0.
   • dx,dy = Größe der Grafik, bzw. Offset der rechten unteren Ecke der anzuzeigenden Grafik, bezogen auf den zuvor definierten Startpunkt.
     Bei einem Einzelicon wäre dies schlichtweg die Gesamtgröße des Bildes x*y.
     Beispiel: Das anzuzeigende Symbol ist 22*22 Pixel groß, dann ist einzutragen: 22,22
   • mx,my = Ankerpunkt (I.d.R. der "Mittelpunkt") der Grafik
     Der StreetDirector plaziert die Grafik mit dem hierdurch bezeichneten Pixel auf der exakten Position des POI, die Definition erfolgt relativ zur rechten unteren Ecke der Grafik, daher i.d.R. Regel negativ, um den Ankerpunkt innerhalb der Grafik zu haben.
     Faustformel: Sofern Ihr keine speziellen Spielereien wollt, ist hier jeweils die Hälfte von dx und dy mit negativem Vorzeichen einzutragen, damit das Icon mittig auf dem POI angezeigt wird. Kleines Gedankenspiel: Wäre die POI-Grafik ein nach links oben zeigender Pfeil, der genau auf den POI zeigen soll, dann wären einfach dx und dy mit negativem Vorzeichen einzusetzen, damit die Grafik mit der linken oberen Ecke auf dem POI liegt. Für einen nach rechts unten zeigenden Pfeil wäre dementsprechend 0,0 einzutragen.
     Beispiel: Unsere zuvor gewählte, 22*22 Pixel große Grafik soll mittig auf dem POI dargestellt werden, also ist hier -11,-11 einzutragen.
   • r,g,b = Die Rot/Grün/Blau-Werte der transparenten Farbe
     Die durch die drei Werte definierte Farbe wird nicht angezeigt, sondern durchsichtig dargestellt, so daß hier die Karte durchscheint. In der Praxis kaum verwendet, da auch der sogenannte Alpha-Channel, also die PNG-eigene Transparenz, unterstützt wird. Diese ist meist leichter in einer Grafikdatei vorzusehen, als die rot-grün-blau-Werte für die Farbe zu ermitteln, die man als transparente Farbe vorgesehen hat.
     Wird der Alpha-Channel verwendet, entfallen diese Werte.
4. Zeile: ppp = Priorität des POI bei der Darstellung
   Da sich POI auch so nah beinander liegen können, daß der StreetDirector nicht alle auf einmal anzeigen kann, kann definiert werden, wie wichtig die Anzeige eines POI ist.
   Je niedriger dieser Wert ist, desto höher ist seine Priorität, oder umgekehrt, je höher dieser Wert ist, desto eher wird der POI nicht angezeigt, weil ein anderer, wichtigerer angezeigt werden muß.
   Tankstellen an sich zeigt GoPal z.B. mit einer Priorität von 10, Tanskstellen für die die Marke hinterlegt ist hingegen mit Priorität 9. Dadurch ist gewährleistet, daß das Markenlogo angezeigt wird, auch wenn die Tankstelle zusätzlich noch als "irgendeine Tankstelle" hinterlegt ist. Diesen Gedanken weitergeführt wird der Fahrer eines auf Gas umgebauten Fahrzeuges sich eher für die Verfügbarkeit von Gas an einer Tankstelle als die Marke interessieren, so daß hierfür dann entsprechend mindestens die Priorität 8 gewählt werden sollte. Dann gewinnt die Typdefinition von LPG gegen die der Marke, die zuvor das generische Tankstellensymbol verdrängt hat.
   Beispiel: Beliebige Einkaufsziele haben die Priorität 200. Damit das Markenlogo gegen den allgemeinen Einkaufswagen gewinnt, wählen wir als Priorität 199.
5. Zeile (Optional): zmin und zmax = Zoom-Level für die Anzeige
   Über diese beiden Werte kann bestimmt werden, bei welchem Zoomlevel (Maßstab) ein POI angezeigt werden soll.
   Die Werte, geteilt durch 10, entsprechen dem Maßstab in km, ein Wert von 10 bedeutet demnach 1km, während 5 für 500m steht.
   Der POI wird angezeigt, wenn der Zoomlevel zwischen den über zmin und zmax definierten Grenzen liegt. Obwohl zmax bis 65535 eingestellt werden kann, ergeben Werte über 29 keinen Sinn, weil ab einem Zoomlevel von 3km sowieso keine POI mehr angezeigt werden.
   Wird diese Zeile ausgelassen, wird der POI ab einem Zoomlevel von 200m angezeigt, dies entspricht der Einstellung zmin=0 und zmax=2.
   Beispiel: Um einen POI in jedem Zoomlevel (bis 2,9km) anzeigen zu lassen, wird zmin auf 0 und zmax auf 65535 gesetzt. Soll ein POI nur angezeigt werden, wenn man auf 500m oder darunter ranzoomt, würde man zmin auf 0 und zmax auf 5 setzen.
6. Zeile: aaaa - Der Code Agent für die POI
   Sagt GoPal, unter welcher ID er in Kartenmaterial und Overlays nach diesen POI suchen soll. Eine Referenz bereits bekannter IDs gibt es ebenfalls hier im Forum. Für selbst erstellte Overlays kann die ID selber gewählt werden, es sollte aber keine bereits genutzte oder reservierte sein (Ebenfalls in der Referenz zu ersehen).
   Beispiel: Für unsere Lidl wäre 9800 einzugeben.
7. Zeile: </type> = Abschluß der Typdefinition

Zusammenfassung

Im Endergebnis sähe unser Beispiel also so aus:

Für GoPal 3 und 4 (Mit Kategorieicon):


Für andere Systeme (ohne Kategorieicon):


Diese Zeilen fügen wir entweder dem Abschnitt
<types>
[...]
</types>
in der POI.PC direkt hinzu, oder wir speichern diese Definition für eine POIVerwaltung unter [i]POIVerwaltung\All_POI ab, z.B. als EK_Lidl_NJ.txt

Nach dieser Änderung und einem Neustart der Navigationssoftware sollten die neu definierten POI bereits in der Karte angezeigt werden, zumindest wenn wir auch das Overlay dazu installiert haben, bzw. es sich um POI aus dem Kartenmaterial handelt.

Hinzufügen/Ändern einer Kategorie für die Suche nach Sonderzielen (Medion GoPal)

Da wir bei den meisten POI auch in der Lage sein wollen, diese gezielt zu suchen statt sie nur in der Karte anzeigen zu lassen, müssen wir diese auch einer Kategorie hinzufügen bzw. eine vorhandene Kategorie anpassen, damit diese auch unsere neue POI-Gruppe umfaßt.

Bei Medion GoPal 2.x-4.x erfolgt auch die Kategoriedefinition in der POI.PC
Eine einzelne Kategorie kann sowohl eine einzige POI-Gruppe als auch beliebig viele POI-Gruppen enthalten.

Die Definition einer Kategorie sieht so aus:

<!-- Kommentar -->
<category id="cc">
<type id="id1"/>
<type id="id2"/>
...
<type id="idn"/>
</category>

An den blau markierten Stellen sind Werte einzusetzen, grüne Werte sind zu ändern bzw. einzusetzen und an der rot markierten Stelle können zusätzliche Zeilen eingefügt werden.

Erklärung der einzutragenden Werte:

• 1. Zeile (Optional): Kommentar
  Vor der eigentlichen Definition kann ein Kommentar stehen, z.B. der Name der Kategorie.
  Da es sich nur um einen Kommentar handelt, kann diese Zeile natürlich auch ersatzlos entfallen.
  Beispiel: <!-- Einkaufen Discounter -->
• 2. Zeile: Kategorie-Nummer (cc) und Einleitung der Kategoriedefinition
  Die Nummer, die Ihr dieser Kategorie zuweisen wollt.
  Jede ID darf nur einmal genutzt werden. Wird das nicht eingehalten, nutzt das Programm die, die in der POI.PC zuerst auftaucht.
  Beispiel: Um die Kategorie 55 zu definieren, geben wir ein <category id="55"> ein.
• 3.-n. Zeile: Eine Liste von Typ-IDs, die von der Kategorie gefunden werden sollen.
  Beispiel: Um alle POI mit der Typ-ID 9800 zu finden, fügen wir die Zeile <type id="9800"/> ein. Dies wiederholen wir mit allen Typ-IDs, die zur Kategorie gehören sollen.
• letzte Zeile: </category> = Abschluß der Kategoriedefinition

Zusammenfassung

Im Endergebnis sähe unser Beispiel also so aus:

Für GoPal 3 und 4 (Mit Kategorieicon):


Damit würden durch die Kategorie 55 die ALDI Nord, ALDI Süd und Hofer aus dem bei ALDI-Geräten mitgelieferten ALDI-Overlay, als auch die NaviJoy-Lidl gefunden werden.

Diesen Block fügen wir bei GoPal 3.x und 4.x entweder dem Abschnitt
<search>
[...]
</search>

bzw. bei GoPal 2.x den beiden Abschnitten
<search type="name">
[...]
</search>
und
<search type="proximity">
[...]
</search>
hinzu, oder wir speichern diese Definition für eine POIVerwaltung unter POIVerwaltung\All_Category ab, z.B. als Einkaufen-Discounter.txt

Damit ist der Inhalt der Kategorie 55 definiert.
Aber woher weiß denn jetzt das Navi, daß diese Kategorie "Einkaufen (Discounter)" heißen soll, bzw. daß es diese Kategorie überhaupt gibt?
Antwort: Tut es noch garnicht.

Um der Navisoftware zu sagen, daß es die Kategorie überhaupt gibt, muß für GoPal 2.x und 3.x die folgende Zeile:
<category id="cc" name="400tt" />
dem Abschnitt
<categories>
...
</categories>
der POI.PC, bzw. bei Verwendung/Erweiterung einer POIVerwaltung in der POI_3.PC (Bei GoPal 2.x: POI_3a.PC) zugefügt werden, bzw. diese sollte schon existieren, wenn eine vorhandene Kategorie erweitert oder geändert wurde.

Bei GoPal 4.x sieht die zuzufügende bzw. zu überprüfende Zeile wie folgt aus:
<category id="cc" name="tt" bitmapIndex="bb" />

Dabei steht cc für die Kategorie-Nummer (Wie bei der Definition der Kategorie vergeben), tt für die Textnummer und - bei GoPal 4.x - bb für das durch die Kategorie für POI-Gruppen ohne eigene Kategorieicon-Angabe zu verwendende Bild aus der poi_categories.

Die Angaben für cc und ggf. bb sind einfach zu finden:
cc haben wir selber festgelegt und auch bb suchen wir uns einfach selber aus. Die Angabe von bb sagt: bb-tes Bild von oben innerhalb der poi_categories (Bei 0 angefangen zu zählen).

tt ist etwas schwerer zu bestimmen (Sofern wir nicht nur eine vorhandene Kategorie ändern):

Bei GoPal 2.x und 3.x wählen wir eine Zahl zwischen 40000 und 40099, die noch nicht von einer anderen Kategorie belegt ist. Leider gibt es bei den schon definierten Kategorien einen Versatz zwischen Kategorie- und Textnummer, ansonsten könnte man auch wieder dieselbe Nummer wie für die Kategorie nehmen, so liegt aber die Textnummer meist 1-2 darunter.
Theoretisch könnten auch Zahlen bis 41999 für Kategorietexte verwendet werden, allerdings werden nur die Texte 40000 bis 40099 alphabetisch sortiert (Dank an Dosenpfand, der dies festgestellt hat).

Bei GoPal 4.x ist dieser Part noch schwieriger: In einer weiteren Konfigurationsdatei ist eine Liste abgelegt, in der dann die eigentlichen Textnummern hinterlegt sind, d.h. die "Textnummer" ist gar keine, sondern sagt der Software nur, daß in besagter Liste an z.B. 54. Stelle die Textnummer hinterlegt ist!
Wer sich das erste Mal daran macht, sollte also bei GoPal 4.x zuerst nur vorhandene Kategorien umändern oder erweitern, bevor er sich an den Versuch macht, zusätzliche Kategorien zu definieren!

Fortsetzung folgt...

.

.

.

.

.

.

Moin SpaceRat,

Klasse Anleitung, vielen Dank!

Ich habe auch (glaube ich) fast alles verstanden, bis auf diesen Punkt:


Wie muss diese Liste (Datei) denn aussehen, welchen Namen muss die haben und wo muss die liegen???
Stehe da gerade etwas auf dem Schlauch! Sorry für die Anfängerfragen

Schönen Sonntag,

Gruß Dale
---