Anleitung zur POI Verwaltung: Unterschied zwischen den Versionen

Aus GoPalWiki
Wechseln zu: Navigation, Suche
(1. Welche Dateien werden benötigt)
Zeile 135: Zeile 135:
 
<br>
 
<br>
  
= '''1. Welche Dateien werden benötigt''' =
+
== '''1. Welche Dateien werden benötigt''' ==
  
 
Für die Auswertung und Anzeige der POI’s sind die folgenden Module zuständig:  
 
Für die Auswertung und Anzeige der POI’s sind die folgenden Module zuständig:  

Version vom 14. April 2010, 07:06 Uhr

Vorlage:PDF

POI Verwaltung Anleitung

Die POI Verwaltung dient zum Einstellen der angezeigten POIs in GoPal.

Durch die Verwaltung werden alle in Gopal vorhandenen POIs freigeschaltet und zusätzlich kann man eigene Overlays einbinden z.B. von NaviJoy oder Navifriends.


Der Startbildschirm

POI Verwaltung Erklaerung.jpg


Erstellung einer neuen POI.PC

Um eine POI Konfiguration zu erstellen startet Ihr die Verwaltung, auf der linken Seite werden euch alle POIs angezeigt. Hier wählt Ihr die gewünschten POIs aus durch anklicken (diese werden dann blau unterlegt angezeigt).

Beispiel mit den Alfa Romeo POIs

POI Verwaltung 1.jpg

anschließend klickt Ihr unten in der Mitte auf den Button (ausgewählte Dateien verschieben) damit die Datei in den rechten Bildschirm verschoben wird.

POI Verwaltung 2.jpg

Ihr könnt auch mehrere POIs gleichzeitig auswählen und verschieben

POI Verwaltung 3.jpg

POI Verwaltung 4.jpg

Die Namen der POI-Definitionen folgen diesem Schema:
KK_UU_Name_QQ.txt (Dabei können UU_ und QQ auch entfallen)
Die ersten beiden Buchstaben geben eine grobe Einstufung der Art des POI wieder, z.B. FZ für Freizeit oder EK für Einkaufen. Manche dieser Gattungen sind zusätzlich noch feiner unterteilt, Einkaufen z.B. hat die Untergattungen LM für Lebensmittel, GH für Großhandel, EM für Elektronikmärkte, usw.
Darauf folgt der Name des POI, bei Supermärkten z.B. der Name der Kette.
Am Ende steht ggf. noch eine Quelle für diese POI, z.B. _NJ, wenn diese POI aus einem NaviJoy-Overlay stammen. Nur POI ohne ein solches Suffix stammen aus dem Kartenmaterial und können ohne weiteres genutzt werden. Für POI mit Suffix muß auch das entsprechende Overlay auf's Navi kopiert werden.

Beispiel:
EK_LM_REWE_NJ.txt
Es handelt sich um ein Einkaufsziel (EK) für Lebensmittel (LM), genauer die REWE-Märkte, und es ist das entsprechende Overlay von NaviJoy nötig.

anschließend schaltet Ihr zur Kategorie Auswahl um (Wechsel POIs Kategorie anzeigen).

POI Verwaltung 5.jpg

Hier wählt Ihr wieder alle Kategorien aus die in Gopal unter dem Button Sonderziele angezeigt werden sollen (natürlich in Abhängigkeit zu den vorher gewählten POIs) und verschiebt diese wieder nach rechts durch Klick auf den Button unten in der Mitte.

POI Verwaltung 6.jpg

POI Verwaltung 7.jpg

Zum Schluss klickt Ihr unten rechts auf den Button POI.PC Nun erscheint eine Abfrage ob eine CFG Datei erstellt werden soll, hier habt Ihr zwei Möglichkeiten.

POI Verwaltung 8.jpg

Bei Nein wird nur die POI.PC Datei erstellt und eure Auswahl nicht gesichert.
Bei Ja wird die Tastatur eingeblendet und Ihr könnt einen Namen für die Konfigurationsdatei eingeben.

POI Verwaltung 9.jpg

POI Verwaltung 10.jpg

Nach der Eingabe klickt Ihr auf den Button POI.PC unten rechts, nun wird die Konfigurationsdatei gespeichert und die POI.PC erstellt. Zum Schluss schlisst sich die POI Verwaltung und Ihr könnt GoPal starten und habt die ausgewählt POIs in der Karte.


Arbeiten mit Konfigurationsdateien

Konfigurationsdateien dienen dazu bestimmte POI Einstellungen zu sichern und über diese Dateien schnell wieder herzustellen.
Ihr startet wieder die POI Verwaltung, dann klickt Ihr unten rechts auf den kleinen Pfeil (voreingestellte Profile wählen) vor dem Button POI.PC

POI Verwaltung 11.jpg

Hier klickt Ihr dann ein Profil an, in diesem Beispiel nehmen wir wieder die oben erstellte Konfigurationsdatei Test.

POI Verwaltung 12.jpg

Nach dem anklicken von Test werden links automatisch alle POIs und Kategorien markiert und nach rechts verschoben die in dieser Konfigurationsdatei gespeichert wurden. Zum Schluß klickt Ihr unten rechts wieder auf den Button POI.PC und wartet bis sich die POI Verwaltung geschlossen hat. Dann startet Ihr wieder GoPal und habt wieder die gewählten POIs und Kategorien in GoPal zur Verfügung.

Inhalt der mitgelieferten Profile/Konfigurationen

POIVerwaltung von NaviJoy/SpaceRat

GP_Original_3.cfg / GP_Original_4.cfg / GP_Original.cfg (alt)

Die den Originaleinstellungen von GoPal ähnlichste Zusammenstellung von POI und Kategorien. Kategorien und angezeigte/suchbare POI sind dieselben wie in der Werkskonfiguration. Technisch bedingt erhalten diese aber dennoch die genaueren, bzw. markenbezogenen Logos.

GP_Original_3.cfg entspricht dabei der Werkskonfiguration von GoPal 3.x, GP_Original_4.cfg der von GoPal 4.7, unabhängig davon auf welchem GoPal die POIVerwaltung genutzt wird!

GP_Original_mehr_POI.cfg

Bzgl. der Kategorien wie GP_Original, allerdings werden in die Originalkategorien passende Zusatz-POI mit unterstützt.

Beispiel: Es gibt wie in GP_Original nur eine Einkaufskategorie, in dieser werden dann aber z.B. REWE oder Edeka aus den NaviJoy-Overlays angezeigt.

GP_Voll.cfg

Wie GP_Original_4.cfg, zusätzlich sind auch alle Original-Kategorien freigeschaltet, die in der Werkskonfiguration nicht aktiv sind.

GP_Voll_mehr_POI.cfg

Bzgl. der Kategorien wie GP_Voll, allerdings werden in diese passende Zusatz-POI mit unterstützt.

Alle_POI.cfg

Es sind alle Original-Kategorien sowie alle zusätzlichen Kategorien vorhanden. Alle POI, sowohl die aus dem Kartenmaterial als auch die aus Zusatzoverlays, werden gefunden.

SpaceRat.cfg

Konfiguration des Autors Wer unsportlicher Kulturbanause ist, findet hier eine gute Basiskonfiguration. Ggf. sind die Automarken VW/Audi/SEAT/Skoda bzw. Mazda noch an die persönlichen Bedürfnisse anzupassen :)

POI Overlay einfügen

GoPal kann nur mit PSF Dateien umgehen, also müsst Ihr die Overlays als PSF Dateien laden und diese dann in den Ordner MapRegions einfügen.
Entweder auf der Storage Card im Ordner MapRegions oder in My Flash Disk\navigation\MapRegions
Anschließend die POI Verwaltung starten und in eurem gewähltem Profil schauen ob auch die Overlays und Kategorie ausgewählt ist.
Also wenn Ihr z.B. das LPG Overlay eingefügt habt, dann müsst Ihr in der POI Verwaltung unter POI den Eintrag TS_Autogas_LPG_NJ.txt nach rechts verschieben und unter den Kategorien den Eintrag Tankstellen-LPG.txt nach rechts verschieben.

Dann auf POI.PC klicken.
Danach habt Ihr in GoPal unter Sonderziele den Eintrag "Tankstelle (LPG)" und könnt über diesen die Tankstellen suchen.

Wo bekomme ich POI Overlays

Bei einigen GoPal Versionen sind schon solche Overlays dabei, diese findet Ihr auf der DVD im Ordner POI. (Aldi.psf, Hotel.psf)

Zusätzliche Overlays bekommt Ihr z.B. bei:

NaviJoy.de

Navifriends.de


POI Erstellung und Verwaltung unter GoPal Version 5

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

Vorlage:Adsense