Logo

FreieTonne

Forum Kontakt Seekarte Logbuch Download Windows Download Linux Download Mac Download Mobilgeräte Menu

OSM-Konverter

Mit dem OSM-Konverter können Sie OSM/OSC-Dateien durchsuchen, und eine für FreieTonne lesbare Datei ausgeben lassen. Dabei kommt es darauf an, welche "Regeln" Sie definieren, um zu bestimmen, wie die interessanten Daten bei OSM getagged sind, und welchem Symbol dies in der FreienTonne entspricht.

Um das Programm zu nutzen, benötigen Sie PHP 4+ (als CLI wäre schön), bzw. unseren FT-USB, auf welchem zukünftig alles enthalten ist. Programmaufruf über CLI:
php -f osmkonverter.php eingangs.osm ausgabe.xml

Filter-Regeln

Das Programm benötigt eine Datei "rules.xml", welche alle Filter-Regeln im XML-Format enthält. Die FreieTonne erstellt dynamisch eine vorgefertigte Datei aus den Definitionen, welche bei unseren Symbolen angegeben wurden. Sie können Sie unter nachfolgendem Link herunterladen, oder automatisch per Update ihres FT-USB. Wie Sie die Regeln selbst erstellen/ bearbeiten können, erlesen Sie bitte auf der Seite Rules.XML.

http://www.freietonne.de/ft_icons/auto-rules.php

Bei OSC-Dateien werden gelöschte Nodes (im <delete> Element) geprüft, ob diese in der CSV-Datei enthalten sind (siehe "OSM-ID als Condition" weiter unten), und wenn die Version höher ist, wird die OSM-ID in einer separaten Datei ausgegeben: "deleted_osm_nodes.csv"
Dateiformat: text/plain utf8 - Pro Zeile: OSM-ID|Versionsnummer

Memory-Effekt OSM-IDs

Von jedem Node, welcher Ihr Konverter bereits einmal bearbeitet bzw. aufgenommen hat, werden OSM-ID und dazugehörige Versionsnummer gespeichert (Datei "osmids.log"). Diese Nodes werden zukünftig nicht mehr untersucht, es sei denn, die Versionsnummer ist neuer (wurde bearbeitet).

Dateiformat: text/plain utf8 - Pro Zeile: OSM-ID|Versionsnummer

Sie können auch eine von FreieTonne dynamisch erstellte Datei verwenden, welche alle OSM-IDs mit Versionsnummern enthält, welche zur Zeit in der Datenbank der FreieTonne aktuell sind.

http://www.freietonne.de/ft_pois/osmids-version.php

OSM-ID als Condition

Anstatt wie bei den Rules nach "Conditions", also genutzte Tags der Nodes, gefiltert wird, können auch OSM-IDs übergeben werden. Diese werden im gleichen Format wie zuvor in einer Datei "osmids.csv" bereitgestellt. Ein Node von OSM mit einer ID welche sich in dieser Datei befindet, und eine höhere Version besitzt, wird in jedem Fall mit ausgegeben. Sie können z.B. alle der FT bekannten Positionen so mit aufnehmen, auch wenn bei diesen zum Beispiel die TAGs gelöscht wurden.

Dateiformat: text/plain utf8 - Pro Zeile: OSM-ID|Versionsnummer

Eine aktuelle Liste von der FreieTonne können Sie herunterladen (nicht gelöschte Positionen, mit einer OSM-ID):

http://www.freietonne.de/ft_pois/osmids-version.php

Ausgabe von FT-Daten

Bei der Ausgabedatei handelt es sich ebenfalls um eine XML-Datei, ähnlich des OSM-Formats, allerdings mit eigenen Elementen und Definitionen. Siehe FT-Format für Details.

Dieses Format können Sie für unsere Eingabeschnittstelle nutzen (neben dem bereits existierenden GPX-Upload), um den Datenbestand der FreienTonne zu ergänzen, bzw. zu aktualisieren.

User-Blacklist

Da es immer wieder zu erheblichen Störungen und Fehlinformationen von bestimmten Nutzern aus OSeaM kam, wurde eine Blacklist im Converter eingebaut. Änderungen bestimmter Nutzer werden ignoriert. Eine spätere Änderung eines anderen Nutzers wird aber wieder mit aufgenommen. Somit können wir den Zeitraum bis zur Korrektur durch andere Nutzer hoffentlich auf unserer Karte überbrücken. Dieses Verfahren greift nur bei den stündlichen Aktualisierungen von OSM.

In den folgenden beiden Bereichen gilt keine Blacklist:
Natürlich können auch bestimmte OSM-IDs von der Blacklist ausgenommen werden.