DE:Anpassen der Vorlagen von JOSM

Hilfe
Hilfe für Kartennutzer GPS-Tracks Editoren ABC der Objekt-Eigenschaften Objekt-Eigenschaften OSM-Forum Mailing-Liste

Allgemeines

JOSM bringt eine Liste von Vorlagen mit sich. Da jeder Mapper sich nur mit einem Teil der Objekte beschäftigt, ist es manchmal sinnvoll diese Liste zu ergänzen oder Teile zu löschen.

Die Basis-Vorlagen (defaultpresets.xml) sind in JOSM fest eingebaut.

Man kann allerdings eigene Vorlagen hinzufügen oder fremde Vorlagen benutzen. Hier in diesem WIKI nennen wir die Datei mal z.B. eigene-presets.xml und diese ist im XML-Format geschrieben. Einfach selbst erstellen (z.B. mit dem Notepad oder gedit und als XML umbenennen), lokal irgendwo abspeichern und in den JOSM Einstellungen (Bearbeiten - Einstellungen - Einstellungen der Kartenprojektion und -Daten-Interpretation ('Gitternetz'-Icon) - (Reiter) Objektvorlagen - Aktive Objektvorlagen) - + (für Hinzufügen) - den Pfad angeben - OK bestätigen. JOSM neu starten. Es sind auch mehrere Dateien möglich.

Weitere Informationen zu den Steuerparametern finden sich im JOSM-Wiki.

Es ist wichtig, dass die Datei im UTF8 Format abgespeichert wird, da sonst Umlaute und Sonderzeichen nicht richtig dargestellt werden.

presets

Das 'presets' Tag umschließt alle Presetdefinitionen

<presets>
  <!-- items oder groups -->
</presets>

item

Das 'item' Tag beschreibt ein einzelnes Preset. Es hat mindestens einen Namen, optional auch ein Icon.

<item name="Merker" icon="presets/Stop.png" >
   <!-- hier beschreibende Elemente -->
</item>

Beschreibende Elemente können sein:

• combobox eine Vorschlagsliste
• label eine Überschrift
• key ein fester Wert
• text ein frei bearbeitbarer Text
• check ein Ja/Nein Wert
• multiselect eine voreingestellte Merhfachauswahl

group

Das 'group' Tag umschließt ein oder mehrere items. Es hat mindestens einen Namen, optional auch ein Icon.

<group name="HVV - Buslinien" icon="O:/OSM/busgroup.png">
   <!-- hier mehrere items -->
</group>

href

Hiermit kann dem Objekt ein Link zugewiesen werden mit dem die entsprechende Dokumentation im Wiki aufgerufen werden kann.

Beispiel:

 
<link href="http://wiki.openstreetmap.org/wiki/Tag:leisure=slipway" />

Wird in der Vorlage der Key href verwendet, dann gilt dieser Link für alle Sprachen als Basis. Um auf länderspezifische Webseiten zugreifen zu können, sind gesonderte Keys zu verwenden. Den Keys sind dann die Länderkennungen voranzustellen.

Beispiel:

 
 <link    href="http://wiki.openstreetmap.org/wiki/Tag:leisure=slipway"
       de.href="http://wiki.openstreetmap.org/wiki/DE:Tag:leisure=slipway"
       fi.href="http://wiki.openstreetmap.org/wiki/Fi:Tag:leisure=slipway"
 />

key

Hiermit kann dem Objekt ein Tag mit Wert zugewiesen werden; es wird im Formular nicht angezeigt.

Beispiel:

<key key="amenity" value="restaurant" />

text

Möglichkeit zur freien Texteingabe für den Anwender

Beispiel:

<text key="name" text="Name:" />

Wird in der Vorlage der Key text verwendet, dann gilt dieser für alle Sprachen als Basis. Um auch länderspezifische Texte ausgeben zu können sind gesonderte Keys zu verwenden. Den Keys sind dann die Länderkennungen voranzustellen.

In den Defaultpresets sind nur englische Begriffe hinterlegt. Die länderspezifischen Texte werden dort über das Übersetzungspaket gesteuert.

Beispiel:

  <text key="name" text="Operator:" de.text="Betreiber:" />

space

Fügt eine leere Zeile im Dialog ein.

Beispiel:

<space />

check

Abfragen eines Wahrheitswertes (true/false)

Beispiel:

<check key="fuel_octane_98" text="98 Octane" default="off" />

combobox

Stellt dem Anwender eine Auswahlliste zur Verfügung, hierdurch können Tippfehler bei der Arbeit vermieden werden.

Beispiel:

<combo key="tourism" text="Accomodation:" values="hotel,motel,guest_house" />

multiselect

Stellt dem Anwender eine Auswahlliste zur Verfügung, in der Werte schon zu einer Multiauswahl zusammengefügt worden sind.
Das Trennzeichen (delimiter) der einzelnen Werte kann optional mit delimiter="[x]" angegeben werden. Ein defaultmäßig eingestelltes Trennzeichen ";" kann i.d.R. nicht benutzt werden da mit diesem Zeichen dann die Keywerte getrennt werden.

Beispiel:

<multiselect key="operator" delimiter="," text="operator" de.text="Betreiber der Halteposition" values="VAS,JES,VAS;JES" />

Beschreibung der Attribute der einzelnen Elemente

key

steht für den Tag der dem Objekt zugewiesen wird

value

Den zuzuweisenden Wert für den Tag

• Pflichtattribut in key

text

Beschriftung es Elements im Formluar

• Pflichtattribut in combobox, text und check

default

Startwert

• Optionales Attribut in combobox, text und check

Bei check sollte der Wert 'on' oder 'off' sein.

delete_if_empty

Wurde entfernt.

values

Vorschlagswerte für eine combobox, mit Komma getrennt (Beispiel).

• Pflichtattribut in combobox

icon

Der Pfad auf ein Icon.

Der Pfad ist ein absoluter Dateiname (Beispiel), oder relativ zur JAR Datei (Beispiel).

Das Icon sollte als PNG vorliegen und quadratisch sein. Ferner sollte die Hintergrundfarbe transparent sein, da es sonst in der Toolbar merkwürdig aussehen könnte.

• Optionales Attribut in item und group

type

Beschreibung für welchen Objekttyp das item zulässig ist.
Zulässige Werte sind: 'node' = ein Node, 'way' eine Strecke, 'closedway' eine Area, 'relation' eine Relation. Im Dialog werden die entsprechenden Icons dargestellt.

Mehrere Werte mit Kommatas getrennt sind zulässig also:

<item name="Fountain" icon="presets/spring.png" type="node,closedway">
   <!-- hier beschreibende Elemente -->
</item>

• Optionales Attribut in item

name

Text, der im Menü oder in der Toolbar dargestellt wird

• Pflichtattribut in item und group

use_last_as_default

Attribut um die Werte der letzten Eingabe automatisch als Defaultwert zu übernehmen. Findet zum Beispiel Anwendung bei der Erfassung von Adressen.

Mögliche Werte true / false.

display_values

Eine Komma-getrennte Auflistung mit Werten die alternativ für die Eintragungen des Parameters value angezeigt werden sollen. Die Reihenfolge muss dem von Value entsprechen. Für deutschsprachige Werte kann alternativ de.display_values verwendet werden (siehe auch text).

• Optionales Attribut in combobox
• Optionales Attribut in multiselect

short_description

Für jeden der Werte in dem Parameter display_value kann eine Kurzbeschreibung hinterlegt werden wobei hier auch die Reihenfolge denen von display_values entsprechen muss. Die Kurzbeschreibungen sind hierbei wie folgt aufzubauen:

<short_description>erste Beschreibung</short_description>
		...
<short_description>letzte Beschreibung</short_description>

(Wo werden diese Angaben in JOSM angezeigt? Im JOSM 5667 werden sie zumindest nicht angezeigt. Untenstehendes funktioniert aber.)

Alternativ zur Aufzählung der Optionen in einem String-Parameter innerhalb einer kommaseparierten Liste ist auch die Aufzählung der Werte mit je einem eigenen Tag möglich:

<combo key="" text="">
<list_entry value="erster Wert" display_value="ein Wert" short_description="erste Beschreibung" />
<list_entry value="zweiter Wert" display_value="ein anderer Wert" short_description="zweite Beschreibung" />
</combo>

• Optionales Attribut zu combobox
• Optionales Attribut zu multiselect

Beispiele für Presets

Es muss nicht immer ein Dialog kommen damit Tags zugewiesen werden können. Besteht der Key immer nur aus einem key-value-Paar dann werden nur die Daten zugewiesen.

One-Klick-Beispiel

<item name="1Click-bridge" de.name="1-Klick-Bruecke" icon="present/bridge.png" type="way,closedway">
    <key key="bridge" value="yes" />
    <key key="layer" value="1" />
</item>

Weitere Beispiele für die Erfassung von Straßendaten finden sich im OneClick-Preset.

Tankstelle

<item name="Tankstelle" >
    <link href="http://wiki.openstreetmap.org/wiki/DE:Tag:amenity=fuel" />
    <label text="Tankstelle" />  
    <key key="amenity" value="fuel" /> 
    <combo key="name" text="Name" values="Shell,Aral,Esso,Freie" default="" />
    <combo key="operator" text="Betreiber" values="Shell,Aral,Esso,Freie" default="" />
    <check key="fuel:diesel" text="Diesel" />
    <check key="fuel:octane_91" text="Normalbenzin" />
    <check key="fuel:octane_95" text="Superbenzin" />
    <check key="fuel:octane_98" text="Superplus" />
    <check key="fuel:1_25" text="Zweitaktgemisch 1:25" />
    <check key="fuel:1_50" text="Zweitaktgemisch 1:50" />
    <check key="fuel:biodiesel" text="Biodiesel" />
    <check key="fuel:svo" text="Reines Pflanzenöl als Treibstoff"  />
    <check key="fuel:biogas" text="Biogas" />
    <check key="fuel:lpg" text="Autogas (lpg)" />
    <check key="fuel:cng" text="Erdgas (cng)" />
    <check key="fuel:hydrogen" text="Wasserstoff" />
    <check key="fuel:electricity" text="Anschluss für Elektroautos" />
    <optional>
       <text key="opening hours" text="Öffnungszeiten" default=""/>
       <link href="http://wiki.openstreetmap.org/wiki/DE:Key:opening_hours?uselang=de" />
       <check key="payment:maestro_card" text="Master-Card" default="off" />
       <check key="payment:ec" text="EC-Card" default="off" />
       <check key="payment:banknotes" text="Geldscheine" default="off" />
     </optional>
</item>

Drogerie

<item name="Drogerie">
    <link href="http://wiki.openstreetmap.org/wiki/DE:Map_Features#Gesch.C3.A4fte" />
    <label text="Drogerie" />
    <key key="shop" value="chemist" />
    <text key="name" text="name" />
    <combo key="operator" text="Kette" values="Schlecker,Rossmann,Budnikoswsky" default="" />
</item>

Bushaltestelle des Hamburger Verkehrsverbundes

<item name="HVV Bushaltestelle" >
    <link href="http://wiki.openstreetmap.org/wiki/DE:Tag:highway=bus_stop" />
    <label text="Bushaltestelle bearbeiten" />
    <key key="highway" value="bus_stop" />
    <text key="name" text="Schildname (name)" />
    <text key="network" text="Netz (network)" default="HVV" />
    <combo key="operator" text="Betreiber (operator)" values="VHH,HHA,PVG,KVG,AK,KVIP" default="" />
    <check key="shelter" text="Schutz" default="off" />
</item>

Buslinie des Hamburger Verkehrsverbundes (Relation)

<item name="HVV-Buslinie" type="relation">
    <link 
    href="http://wiki.openstreetmap.org/wiki/Hamburg/Transportation#Eintragen_von_neuen_Relationen_fü.C3.BCr_die_.C3.96PNV-Karte"
    />
    <label text="HVV Buslinie bearbeiten" />
    <key key="type" value="route" />
    <key key="route" value="bus" />
    <key key="network" value="HVV" />
    <text key="ref" text="Linie (ref)" />
    <text key="name" text="Name" default="HVV-Buslinie xxx" />
    <optional>
        <combo key="operator" text="Betreiber (operator)" values="VHH,HHA,PVG,KVG,AK,KVIP" default="HHA" />
        <text key="from" text="Von" />
        <text key="to" text="Nach" />
        <text key="note" text="Bemerkung" />
    </optional>
</item>

Fahrrad-Verleih (in Verbindung mit StadtRADHamburg)

siehe auch Howto Map A

<item name="Fahrrad-Verleih" >
    <link href="http://wiki.openstreetmap.org/wiki/DE:Howto_Map_A#Fahrrad-Verleih" />
    <label text="Fahrrad-Verleih" />  
    <key key="amenity" value="bicycle_rental" /> 
    <text key="name" text="Name" />
    <text key="network" text="Betreiber" default="stadtradhamburg" />
    <text key="ref" text="Station-Nr." default="" />
    <text key="capacity" text="Anzahl Stellplätze" default="" />
</item>

Eine Liste der Tags ist unter Category:Tags und Category:Tags by value zu finden.

Meilensteine

<item name="Meilenstein" >
    <link href="http://wiki.openstreetmap.org/wiki/DE:Howto_Map_A#Meilensteine" />
    <label text="Meilensteine" />  
    <key key="historic" value="milestone" /> 
    <text key="name" text="Name" default="" />
    <text key="year" text="Jahr" default="" />
    <text key="ref" text="km" default="" />
    <check key="moved" text="verschoben" default="off" />
</item>

Rad- und Fussweg-Kombinationen

Das vorliegende Template berücksichtigt die verschiedenen Kombinationen von Fuß- und Radwegen wie in [1] beschrieben.

<annotations>
	<group name="Fuss-Rad-Weg" icon="presets/cycleway.png">
		<item name="Fussweg-Rad frei (239+Zusatz)" icon="presets/cycleway.png">
			<label text="Fussweg (Rad frei) bearbeiten"/>
			<link href="http://wiki.openstreetmap.org/wiki/DE:Bicycle/overview_ways" 
			/>

			<label text=" "/>
			<key key="highway" value="path"/>
			<key key="foot" value="designated"/>
			<key key="bicycle" value="yes"/>
			<label text=" "/>
			<label text="Optional Attributes:" de.text="Zusatzinformationen:"/>
			<label text=" "/>
			<text key="name" text="Name" de.text="Name" default=""/>
			<check key="oneway" text="Oneway" de.text="Einbahn" default="off"/>
			<check key="bridge" text="Bridge" de.text="Brücke" default="off"/>
			<check key="tunnel" text="Tunnel" de.text="Unterführung" default="off"/>
			<check key="cutting" text="Cutting" de.text="Einschnitt" default="off"/>
			<check key="embankment" text="Embankment" de.text="Damm/Rampe" default="off"/>
			<combo key="layer" text="Layer" de.text="Ebene" values="5,4,3,2,1,0,-1,-2,-3,-4,-5" default=""/>
			<combo key="surface" text="Surface" de.text="Oberfläche" values="paved,unpaved,cobblestone" default=""/>
			<text key="maxspeed" text="Max. speed (km/h)" de.text="max. Geschwindigkeit (km/h)" default=""/>
			<text key="width" text="Width (metres)" de.text="Breite (Meter)" default=""/>
		</item>
		<item name="Fuss-|Radweg (240)" icon="presets/cycleway.png">
			<label text="Fuss-|Radweg bearbeiten"/>
			<link href="http://wiki.openstreetmap.org/wiki/DE:Bicycle/overview_ways" 
			/>
			<label text=" "/>
			<key key="highway" value="path"/>
			<key key="foot" value="designated"/>
			<key key="bicycle" value="designated"/>
			<key key="segregated" value="no"/>
			<label text=" "/>
			<label text="Optional Attributes:" de.text="Zusatzinformationen:"/>
			<label text=" "/>
			<text key="name" text="Name" de.text="Name" default=""/>
			<check key="oneway" text="Oneway" de.text="Einbahn" default="off"/>
			<check key="bridge" text="Bridge" de.text="Brücke" default="off"/>
			<check key="tunnel" text="Tunnel" de.text="Unterführung" default="off"/>
			<check key="cutting" text="Cutting" de.text="Einschnitt" default="off"/>
			<check key="embankment" text="Embankment" de.text="Damm/Rampe" default="off"/>
			<combo key="layer" text="Layer" de.text="Ebene" values="5,4,3,2,1,0,-1,-2,-3,-4,-5" default=""/>
			<combo key="surface" text="Surface" de.text="Oberfläche" values="paved,unpaved,cobblestone" default=""/>
			<text key="maxspeed" text="Max. speed (km/h)" de.text="max. Geschwindigkeit (km/h)" default=""/>
			<text key="width" text="Width (metres)" de.text="Breite (Meter)" default=""/>
		</item>
		<item name="Rad-|Fussweg (241)" icon="presets/cycleway.png">
			<label text="Rad-|Fussweg bearbeiten"/>
			<link href="http://wiki.openstreetmap.org/wiki/DE:Bicycle/overview_ways" 
			/>
			<label text=" "/>
			<key key="highway" value="path"/>
			<key key="foot" value="designated"/>
			<key key="bicycle" value="designated"/>
			<key key="segregated" value="yes"/>
			<label text=" "/>
			<label text="Optional Attributes:" de.text="Zusatzinformationen:" />
			<label text=" "/>
			<text key="name" text="Name" de.text="Name" default=""/>
			<check key="oneway" text="Oneway" de.text="Einbahn" default="off"/>
			<check key="bridge" text="Bridge" de.text="Brücke" default="off"/>
			<check key="tunnel" text="Tunnel" de.text="Unterführung" default="off"/>
			<check key="cutting" text="Cutting" de.text="Einschnitt" default="off"/>
			<check key="embankment" text="Embankment" de.text="Damm/Rampe" default="off"/>
			<combo key="layer" text="Layer" de.text="Ebene" values="5,4,3,2,1,0,-1,-2,-3,-4,-5" default=""/>
			<combo key="surface" text="Surface" de.text="Oberfläche" values="paved,unpaved,cobblestone" default=""/>
			<text key="maxspeed" text="Max. speed (km/h)" de.text="max. Geschwindigkeit (km/h)" default=""/>
			<text key="width" text="Width (metres)" de.text="Breite (Meter)" default=""/>
		</item>
	</group>
</annotations>

Weitere Verweise

• JOSM Dokumentation: http://josm.openstreetmap.de/wiki/TaggingPresets
• JOSM-interne Vorlage: http://josm.openstreetmap.de/browser/josm/trunk/data/defaultpresets.xml
• Weitere Vorlagen zum Übernehmen: http://josm.openstreetmap.de/wiki/De:Presets