Inhaltsverzeichnis

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

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

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.

**Der Aufbau der *.PC-Dateien (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 oder Block

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

</WORT>

geschlossen werden.

Wird in <WORT> mehrere Wörter benutzt, wird nur das erste Wort bis zum Leerzeichen ausgewertet. z.B. <bitmap position="1"> hier ist bitmap das entscheidende Wort und der Bereich muß mit </bitmap> geschlossen werden.

Beispiel:

<Wort>TEXT</ Wort> = <priority>5</priority>
<Wort>Block</Wort> = <type id="1"> <bitmap position="1"> poi/poi.png,0,18,18,18,-9,-9,255,0,255</bitmap> <priority>5</priority> <code agent="PSF">1</code> <description>Airport</description> <group>Standard POITypes</group> </type>

Infos für den Programmierer beginnen immer 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 (Bereich 3.1 bis 3.5)

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

Bereich 3.1 Der Header, er enthält Informationen die GoPal zur Weiterverarbeitung benötigt.

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

Bereich 3.2 „<types>“ in dem festgelegt ist welche POI’s ausgewertet werden.

<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

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

Bereich 3.3 „<categories>“ in dem die (Such)-Kategorien definiert werden.

<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

Bereich 3.4 „<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.

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.

Bereich 3.5 „<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.

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

Weblinks

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

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 zur Datei "dpitems.xml". Aber ich arbeite daran. Klauso

Version 1.1

GoPal 5 POI Grundlagen

Inhaltsverzeichnis

Welche Dateien werden benötigt

Die Aufgaben der Dateien

Dateien mit der Endung “PC“ in den Ordnern :

Dateien mit der Endung PCB

Die Dateien poi_categories.png und poi_categories_national.png

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

Die Datei dpitems.xml

**Der Aufbau der *.PC-Dateien (POI.PC)**

Bereich 3.1 Der Header, er enthält Informationen die GoPal zur Weiterverarbeitung benötigt.

Bereich 3.2 „<types>“ in dem festgelegt ist welche POI’s ausgewertet werden.

Bereich 3.3 „<categories>“ in dem die (Such)-Kategorien definiert werden.

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

Bereich 3.5 „<search type="preferred_pois">“

Zuordnung im Bereich „Sonderziele“

Weblinks

Navigationsmenü

Meine Werkzeuge

Namensräume

Varianten

Ansichten

Mehr

Suche

Navigation

Portale

Wichtige Seiten

Mitmachen

Drucken/exportieren

Werkzeuge