GoPal 5 POI Grundlagen

Inhalt

1. Welche Dateien werden benötigt
2. Die Aufgaben der Dateien
3. Der Aufbau der POI.PC
4. Zuordnung im Bereich „Sonderziele“

---

1. Welche Dateien werden benötigt

Für die Auswertung und Anzeige der POI’s sind die folgenden Module zuständig:

•    GeneralPOIs.pc / GeneralPOIs.pcb
      polyglott.pc / polyglott.pcb
   im Ordner : My Flash Disk\navigation\poi\

•     poi.pc / poi.pcb
      AE_PE_Only.pc / AE_PE_Only.pcb
   im Ordner : My Flash Disk\navigation\poi\default und \navigation\poi\1

•     *.png (POI.png, SpecialBitmaps.png, usw.)
   im Ordner : My Flash Disk\navigation\poi\

•     poi_categories.png und poi_categories_national.png
   im Ordner : My Flash Disk\navigation\Skin480x272\PPSkin\480x272\PPSkin

•     dpitems.xml
   im Ordner : My Flash Disk\navigation\Skin480x272

2. Die Aufgaben der Dateien

Dateien mit der Endung “PC“ in den Ordnern :

   My Flash Disk\navigation\poi\
   My Flash Disk\navigation\poi\default
   My Flash Disk\navigation\poi\1
Dies sind die Hauptdateien in denen die Parameter der POI’s festgelegt werden.

Dateien mit der Endung PCB

Zur Beschleunigung und um Speicherplatz zu sparen wandelt GoPal beim Start alle noch nicht umgewandelten *.PC-Dateien in das kleinere *.PCB-Format um.

Deshalb dauert der erste Start nach einer Neuinstallation so lang.

Die Dateien poi_categories.png und poi_categories_national.png

In diesen beiden Dateien (gleicher Inhalt) sind Bilder enthalten die bei der POI-Suche und in den Splitscreenfenster (2 nächsten POI’s) benutzt werden.

Dateien mit der Endung PNG im Ordner : My Flash Disk\navigation\poi

In diesen Dateien sind die Bilder (Icon’s) der POI’s enthalten die in der Karte angezeigt werden.

Die Datei dpitems.xml

Im hinteren Bereich dieser Datenbank-Datei sind Textbausteine und Verknüpfungen enthalten, die in der POI-Suchfunktion benutzt werden.

3. Der Aufbau der POI.PC

Grundlegendes zur Syntax

Eine Anweisung in dieser Datei ist in mehrere Bereiche aufgeteilt.
Jeder Bereich beginnt mit einem Block

<WORT>

dann kommt die eigentliche Anweisung welche aus mehreren Blöcken bestehen kann

TEXT/Block

und muß mit einem zweiten Block (achte auf / )

</WORT>

geschlossen werden.

 

Infos für den Programmierer beginnen mit
<!--
gefolgt von einem
Text
und enden mit
-->

Das Programm wertet keine Leerzeichen und Tabstopps aus.
Es ist also möglich mehrere Anweisungen/Blöcke direkt hintereinander zu setzen, z. B.

<xyz>bbb</xyz><zyx>ccc</zyx> usw..

Zur Übersichtlichkeit ist jedoch mindestens ein Leerzeichen sinnvoll.

<xyz> bbb </xyz> <zyx> ccc </zyx> usw..

Der Aufbau im Einzelnen

<?xml version="1.0" encoding="ISO-8859-1"?>
<poicategories version="01020010">----------------------
                                                                          |
<types> -------------------------------------                        |
.....                                             | Bereich b)       |
</types> ------------------------------------                        |
                                                                          |
<categories> ------------------------------                        |
.....                                             | Bereich c)       |
</categories> -----------------------------                       |
                                                                         |
<search> ----------------------------------                        |
.....                                             | Bereich d)      |
</search> ----------------------------------                       |
                                                                         |
<search type="preferred_pois">----                       |
.....                                             | Bereich e)      |
</search> ----------------------------------                       |
                                                                         |
</poicategories> ------------------------------------------------

Dateien mit PC-Endung wie die POI.PC, beginnen immer mit einem Header,
der Informationen enthält; die GoPal zur Weiterverarbeitung benötigt.

     <?xml version="1.0" encoding="ISO-8859-1"?>
     <poicategories version="01020010">
     <!--street director Navigation Software -->
     <!--http://www.street-director.de -->
     <!--Copyright (c) 2006 3SOFT GmbH -->
     <!--WARNING: DO NOT EDIT OR DELETE THIS FILE! -->

Anschließend folgt der Bereich „<types>“ in dem festgelegt ist welche POI’s ausgewertet werden.

     <!--Airport-->
     <type id="1">
     <bitmap position="1">poi/poi.png,0,18,18,18,-9,-9,255,0,255</bitmap>
     <overlay1>poi/poi_overlay.png,0,0,19,19,-13,-13,255,0,255</overlay1>
     <overlay2>poi/poi_overlay.png,0,19,17,17,-11,-11,255,0,255</overlay2>
     <zoomlevel min="0" max="40" />
     <priority>5</priority>
     <code agent="PSF">1</code>
     <description>Airport</description>
     <group>Standard POITypes</group>
     </type>

Der Bereich „<types>“ im Einzelnen

<!--Airport--> Titel des POI – nur ein Infotext für Programmierer

<type id="1"> Beginn der POI-Definition mit eindeutige Nummer – wird bei der Suche und Gruppierung verwendet

<bitmap position="1">poi/poi.png,0,18,18,18,-9,-9,255,0,255</bitmap>  Festlegung welches Bild in der Karte und den Auswahlfeldern angezeigt wird

<overlay1>poi/poi_overlay.png,0,0,19,19,-13,-13,255,0,255</overlay1>
<overlay2>poi/poi_overlay.png,0,19,17,17,-11,-11,255,0,255</overlay2>  Wenn mehrere POI’s an einer Stelle sind wird jeweils ein Rahmensymbol zum POI dazugesetzt

<zoomlevel min="0" max="40" />  Hier wird Festgelegt in welchem Zoombereich der POI in der Karte angezeigt wird

<priority>5</priority>  Wenn mehrere POI’s an einer Stelle sind, kann hier festgelegt werden welcher von diesen angezeigt wird (je kleiner die Nummer, um so wichtiger der POI)

<code agent="PSF">1</code>  In dem Kartenmaterial (*.psf) ist durch diese Zahl die Art und der Ort des POI hinterlegt

<codes agent="PSF" begin="2600" end="2759" />  Hiermit kann ein Bereich von Zahlen definiert werden.

<description>Airport</description>  Klassifizierung des POI

<group>Standard POITypes</group>  Klassifizierung des POI-Types

</type>Ende der POI-Definition

Anschließend folgt der Bereich „<categories>“ in dem die (Such)-Kategorien definiert werden.

     <!--Airport-->
     <category id="1021" name="2" bitmapIndex="1" description="Airport" />

    

Der Bereich „<categories >“ im Einzelnen

    

<!--Airport-->	Titel des POI – nur ein Infotext für Programmierer
<category id="1021"	Festlegung welche Nummer diese Kategorie hat. Wird in der Suchfunktion benutzt
name="2"	Texte die bei der Suchfunktion (Sonderziele) ausgegeben werden. Die Nummer gibt eine Position in der Zeile <item id="2131623940" der Datei dpitems.xml an. Die an dieser Position stehende Nummer führt zum Ausgabetext in der Datei Standard.de_DE.xml. Hier sind zurzeit nur Texte bis zur Nr. 108 angegeben. Ab Nr. 109 wird immer der gleiche Text (Alle Sonderziele dieser Kategorie anzeigen) ausgegeben.
bitmapIndex="1"	Verweis auf das dazugehörige Bild in der Datei poi_categories.png. Die Bilder in dieser Datei haben eine einheitliche Höhe von 30 Pixeln, und werden von 0 ab durchnumeriert (z.B. Bild 10 beginnt bei Pixel 300 und endet bei Pixel 329).
description="Airport"	Beschreibung/Bezeichnung des POI

Anschließend folgt der Bereich „<search>“ in dem angegeben wird, welche der einzelne POI’s zu welcher Kategorie gehören.

Diese Anordnung findet man dann auf dem Navi im unter Sonderziele.

     <category id="0">
     <type id="1742" />
     </category>

Der Bereich „<search>“ im Einzelnen

<category id="0">	Eine Kategorie die im Bereich „types“ definiert wurde. Wenn hier mehrere hintereinander stehen, sind diese jeweils Unterkategorien der vorherigen.
<type id="1742" />	Das ist der POI in der jeweiligen Kategorie (es können auch mehrere sein).
</category>	Schließen der Kategorie. Wenn vorher mehrere hintereinander standen, muß jede jeweils durch einen eigenen Eintrag beendet werden.

 Mehr zum Bereich „<search>“ wird im Kapitel 4 beschrieben.

Anschließend folgt der Bereich „<search type="preferred_pois">“

In diesm wird angegeben, welche POI’s unter „Bevorzugte Tankstelle“ angeboten werden. Hier ist die Bedeutung der einzelnen Einträge wie im Bereich „<search>“.
Zur Einstellung „Bevorzugte Tankstelle“ kommt man in Menü über (Zahnrad) Eistellungen/Darstellung/Sonderziele/Bevorzugte Tankstellen.

---

4. Zuordnung im Bereich „Sonderziele“

Welche Gruppen und Untergruppen im Bereich Sonderziele (im Navi über das Menü dann Sonstiges Ziel suchen/Sonderziele) angezeigt werden, kann in der Datei poi.pc im Bereich „<search>“ festgelegt werden.
Es gibt Standardmäßig 8 Hauptgruppen mit der <category id="0" bis <category id="8" (Auto & Verkehr, Einkaufen, Hotel & Gastronomie, …).
In diesen Hauptgruppen können wie in der Gruppe „Auto & Verkehr“ weitere Untergruppen, hier z.B. „Autovermietung, Automobil-Club, Autowerkstatt, usw., enthalten sein. In diesen Untergruppen können dann sowohl weitere Untergruppen als auch POI’s plaziert werden.
Es ist auch möglich einer Hauptgruppe direkt POI’s ohne eine Untergruppe zuzuweißen (z.B. Notfallhilfe).

Hier noch mal ein Beispiel für den Aufbau:

<category id="0" Hauptgruppe
<category id="1001"> <type id="31" /> </category>                      POI
usw.
<category id="1002"> <type id="32" /> </category>                      POI

     <category id="1006">                                                            Untergruppe Ebene 1.1
     <category id="2001"> <type id="33" /> </category>                 POI
     usw.
     <category id="2002"> <type id="34" /> </category>                 POI

          <category id="1007">                                                       Untergruppe Ebene 1.2
          <category id="2003"> <type id="35" /> </category>            POI
          usw.
          <category id="2004"> <type id="36" /> </category>            POI

               <category id="60105">                                                Untergruppe Ebene 2.1
               <category id="2005"> <type id="37" /> </category>       POI
               usw.
               <category id="2006"> <type id="38" /> </category>       POI

Die zugehörigen Bilder die hier angezeigt werden sind in der Datei poi_categories.png hinterlegt(Siehe Kapitel 3.3).

5. Weblinks

Beispiel EASY-POIS  http://www.gopal-navigator.de/dload.php?action=file&file_id=571

---

Dies ist die erste Version der Ausarbeitung.  Es ist wahrscheinlich, dass sie noch den einen oder anderen Fehler enthält, oder einiges noch besser formuliert werden kann. Es fehlt z.b. noch der ganze Bezug ur Datei "dpitems.xml". Ich kann auch nicht 100%ig sagen, dass ich hier alles richtig Herausgefunden habe. Aber ich arbeite daran. Klauso