Seekarte FreieTonne

FT-Format

Für den Import verwenden wir ebenfalls ein XML-Format, allerdings mit etwas eigener Struktur. Da wir noch in der Entwicklung stecken, können jederzeit Änderungen vorgenommen werden.

Elemente
In rot gekennzeichnete Elemente müssen (mindestens ein Mal) angegeben werden. Alle eventuell vorhandenen Parameter, wenn nicht anderes angegeben, müssen vollständig zu jedem Element angegeben und deklariert werden.


<ftpositions>	Grundobjekt, welches alles andere enthält
	Parameter: optional generator, version, timestamp
	Kind von: -
	Anzahl: einmalig

<ftpos>	Eine einzelne Position (Node)
	Parameter: keine
	Kind von: <ftpositions>
	Anzahl: beliebig

<ftsym>	Zu verwendende Symbol-Nummer von der FreienTonne
	Parameter: keine
	Kind von: <ftpos>
	Anzahl: einmalig

<osmid>	OSM-ID des original Nodes
	Parameter: keine
	Kind von:<ftpos>
	Anzahl: einmalig

<version>	OSM-Versionsnummer des original Nodes
	Parameter: keine
	Kind von:<ftpos>
	Anzahl: einmalig

<user>	Benutzername des Uploaders bei OSM
	Parameter: keine
	Kind von:<ftpos>
	Anzahl: einmalig

<bdez>	Breitengrad in Dezimal (lat)
	Parameter: keine
	Kind von:<ftpos>
	Anzahl: einmalig

<ldez>	Längengrad in Dezimal (lon)
	Parameter: keine
	Kind von:<ftpos>
	Anzahl: einmalig

<tag>	Alle TAGs des OSM-Nodes, welche keinen der oben genannten Elemente entsprechen.
	Parameter: k=, v= Entsprechen key und value von OSM
	Kind von:<ftpos>
	Anzahl: einmalig

TAG's mit besonderer Bedeutung für FT
Einige Tags haben für die FreieTonne besondere Bedeutungen, welche zweck eigens einen eigenen Bereich zur Position in unserer Datenbank haben.

name=STRING
Wird als Bezeichnung/ Name der Position eingesetzt.
Wenn es sich bei dem Symbol um eine Tiefenangabe handelt, wird name als Tiefenangabe in Metern angezeigt. Bei Gewässerbezeichnung wird der Text als Bild angezeigt.
description=STRING
Wird als Beschreibung der Position eingesetzt.
comment=STRING
Wird der Beschreibung (siehe description) angehangen.
height=INT
Entspricht einer Höhenangabe in Metern
minzoomlevel=INT
Entspricht der Mindestanzeigenhöhe des Symbols in unserer Karte (im OSM-Format für Zoomstufen).
show_name=yes
Ob bei anderen Kartenmaterial (z.B. GoogleEarth) der Name eingeblendet werden soll.
show_description=yes
Ob das Symbol den Hinweis erhalten soll, dass die Position eine Beschreibung beinhaltet (siehe description). Bei unserer OSM-Karte hat solch ein Symbol dann einen gelben Punkt oben rechts.

Besondere OSM-Tags für, zum Beispiel Lichtsektoren, werden hier später behandelt. Bei einigen der eben benannten TAGs, und wenn sie nicht vorhanden sind, werden automatisch die Einstellungen übernommen, welche bei dem entsprechenden Symbol in der FreienTonne als "default" eingegeben wurden.

OSM-Prüfung
Wenn OSM-ID und Versionsnummer angegeben sind, wird zudem ein Abgleich mit unserer Datenbank vollzogen. Ist die Versionsnummer eines Nodes von OSM größer als der in unserer Datenbank, wird ein Update gemacht, ansonsten nicht.