FreieTonne
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:
- Unser online Formular (Editor)
Wird eine Position in FreieTonne zum Bearbeiten angeklickt, werden zunächst die aktuellen Daten von OSM übernommen. - Neu erstellte See-/ Gewässerzeichen
Bei neuen Positionen gehen wir grundsätzlich davon aus, das die Angaben auch von zweifelhaften Nutzern zunächst in Ordnung sind.