Bab 5 XML dan Preset pada JOSM
VI. Cobalah!
Sekarang coba buka file preset tadi menggunakan JOSM dan lihat bagaimana tampilannya!
●
Buka Preferences pada JOSM dan pilih Tagging Presets, seperti yang telah Anda lakukan sebelumnya.●
Pada bagian kanan di sebelah Active presets, klik tombol +●
Ketik “Household Presets” pada field Name●
Di sebelah URL/File, buka file XML yang baru saja kita buat.●
Klik OK, dan OK lagi untuk menyimpan preferences●
Restart JOSM.●
Buat sebuah layer baru dan tambahkan sebuah titik80
Ringkasan
Selamat! Anda telah mengetahui banyak hal mengenai tag, preset, dan bagaimana cara membuat preset XML Anda sendiri. Dengan menggunakan apa yang Anda pelajari disini, Anda seharusnya sudah bisa membuat preset sendiri untuk menambahkan tag yang berbeda-beda pada data yang Anda miliki.
Jika ada tambahan yang ingin Anda buat pada form yang belum kita bahas disini, silahkan lihat Tambahan berikutnya untuk melihat daftar elemen yang lebih lengkap yang dapat Anda tambahkan ke dalam Presets XML Anda
81
Tambahan
Elemen-Elemen Presets XML
Disini kami tampilkan daftar elemen yang Anda butuhkan untuk Presets XML Anda. Hal ini juga dijelaskan pada wiki JOSM di http://josm.openstreetmap.de/wiki/TaggingPresets.
1. Menu Elements
Berikut ini adalah elemen yang membuat kerangka dari menu preset.
<group> Digunakan untuk group item pada sub menu. name harus ada, icon hanya merupakan atribut pilihan
<item> Setiap item merupakan satu preset yang memungkinkan untuk dipilih. name harus ada, icon hanya merupakan atribut pilihan.
<separator/> Untuk memasukkan garis pemisah ke dalam menu.
2. Form Elements
Elemen-elemen ini memberikan spesifikasi tipe dari tag. Mereka mengkategorisasi bagaimana label dikelompokkan dan bagaimana mereka tampak pada menu.
<label> Teks statis untuk ditampilkan pada form. Text merupakan atribut wajib
<label text="select sport:"/>
<optional> Digunakan untuk mengelompokkan beberapa elemen opsional dari sebuah item. Kemungkinan setara dengan <label text="Optional Attributes:"/>
82 <optional><combo key="boundary" text="Boundary type "values="administrative,national,civil, political"
default="" delete_if_empty="true"/>
<combo key="admin_level" text="Administrative level" values="1,2,3,4,5,6,7,8,9,10" default="" delete_if_empty="true"/></optional>
<space/> Menambahkan spasi (misalnya sebuah baris baru) pada tampilan preset. Kemungkinan setara dengan <label text=" "/>
<label text="Edit Address Interpolation"/><space/><combo key="addr:interpolation" text="Numbering scheme" values="odd,even,all,alphabetic" default="odd"/>
<link> Menambahkan sebuah link website untuk fitur atau hal lainnya. Atribut href wajib dimasukkan. <link href="http://wiki.openstreetmap.org/wiki/Proposed_features/House_numbers/Karlsruhe_Schema"/>
<text> Sebuah field edit text untuk memasukkan arbitrary string dari pengguna. key wajib dimasukkan, text, default dan required hanya opsional. Contoh:
<text key="name" text="Name" default="" delete_if_empty="true" />
<combo> menampilkan kotak pilihan ganda. key dan values wajib dituliskan, dan text, default, editable, dan required opsional (tidak harus). Jika editable-nya true (default), maka kotak pilihan ganda dapat di-edit selayaknya kotak teks (tambahan bagi menu pilihan ke bawah). Kotak pilihan ganda yang tidak bisa diedit hanya bisa memiliki satu dari values/nilai tertentu.
<combo key="religion" text="Religion" values="bahai,buddhist,christian,hindu,jain,jewish,muslim, sikh,spiritualist,taoist,unitarian,zoroastrian" default="" delete_if_empty="true" />
83 <multiselect>
Menampilkan suatu daftar dari item-item yang dapat dipilih, baik satu atau lebih ataupun tidak dipilih sama sekali. key dan values merupakan hal yang wajib, sementara text, default, delimiter, dan required hanya opsional (tidak wajib). Nilai yang telah dipilih akan digabungkan dengan delimiter tertentu (default: titik-koma) dan dituliskan pada nilai dari tag. Jika nilai tag sudah diatur ketika dialog preset dibuka, maka pilihan ganda akan mencoba menandai items yang tepat pada daftar pilihan. Jika nilai tag tidak dapat ditampilkan sebagi daftar dari suatu kombinasi pilihan, maka daftar tersebut akan menjadi tak bisa terpilih (disabled) agar pengguna tidak akan secara tak sengaja menumpuk nilai-nilai yang telah termodifikasi. Berlawanan dengan elemen “combo”, elemen “multiselect” akan memunculkan daftar dari nilai-nilai, deskripsi-deskripsi, dll untuk delimiter yang telah ditentukan, dimana secara default, Anda akan menggunakan titik-koma sebagai delimiter. Anda dapat menentukan delimiter menjadi=”,” tetapi berarti sebuah koma akan digunakan juga pada nilai tag.
<text key="license_classes" text="License Classes" values="A1;A;B;BE;C" default="" delete_if_empty="true" />
<check>
Sebuah kotak-cek (checkbox) dimana pengguna hanya dapat memilih atau tidak memilih. Atribut key wajib ditulis, sementara text, default, dan required hanya pilihan tambahan.
<check key="fuel:diesel" text="Diesel" default="off" delete_if_empty="true"/><check key="fuel:biodiesel" text="Bio Diesel" default="off" delete_if_empty="true"/><check key="fuel:GTL_diesel" text="Diesel (Gas To Liquid - ultimate diesel)" default="off" delete_if_empty="true"/><check key="fuel:HGV_diesel" text="Diesel for Heavy Good Vehicles" default="off" delete_if_empty="true"/><check key="fuel:octane_91" text="Octane 91" default="off" delete_if_empty="true"/><check key="fuel:octane_95" text="Octane 95" default="off" delete_if_empty="true"/><check key="fuel:octane_98" text="Octane 98" default="off" delete_if_empty="true"/><check key="fuel:octane_100" text="Octane 100" default="off" delete_if_empty="true"/>
84 <key>
Key selalu dibutuhkan, entah pada teks, teks-combo atau pilihan ganda. Jika value yang ditentukan tersedia, maka key akan ditentukan. Jika atribut value dihilangkan, maka atribut key akan dihilangkan juga. Dengan kata lain, <key> tidak menambah apapun yang bersifat deskriptif pada form isian. <key> semata-mata hanya secara otomatis menambahkan sebuah tag ketika preset telah dipilih. Sebagai contoh, jika Anda meng-klik preset building, maka tag <key> secara otomatis menambahkan “building=yes” pada objek. Tag ini mengatur sebuah key pada nilai tertentu.
3. Attributes
Atribut dari tag memiliki arti sebagai berikut:
85 Menunjukkan nama tampilan untuk sebuh item. Nama ini akan ditunjukkan pada pop-up preset untuk menampilkan tagging preset nya.
Contoh. <item name= “bridge”> name_context="context"
Menyediakan konteks untuk nama dari sebuah objek. Ketika terdapat banyak objek dengan nama yang sama, atribut ini menyediakan kejelasan dalam memberikan label. Sebagai contoh, ada aerialway station (stasiun kereta gantung) yang berbeda dengan railway station (stasiun kereta) dapat diketahui melalui atribut ini.
Contoh. <item name="Station" name_context="aerialway”> OR <item name="Station" name_context="railway”>
type="data_type"
Ketika atribut ini digunakan, hanya objek yang diberikan jenisnya yang dapat dipilih untuk tagging preset tersebut. Pilihannya termasuk “node”, “relation”, “way”, “closedway” atau kombinasi apapun yang dipisahkan oleh koma.
Contoh. <item name="Gondola" type="way"> icon="iconname"
Menentukan icon (simbol) apa yang akan digunakan. Nama dari icon harus berada dalam satu folder dengan subdirektori dari /images/symbols. Anda dapat memasukkan plugin-jar untuk menyediakan images (gambar) tersebut. Gambar ini akan digunakan sebagai icon untuk ditampilkan di daftar pilihan dan ketika menambahkan preset ke dalam toolbar. Ukuran icon harus berukuran kuadrat.
Contoh. <item name="Construction" icon="presets/construction.png" type="way"> key="some_key"
Menentukan property key yang akan dimodifikasi oleh item tersebut.
Contoh. <key key="junction" value="roundabout" /> OR <check key="tunnel" text="Tunnel" default="off" />
<key key=>, <text key= >, <check key= >, <combo key= >,
text="Any text"
Text ini adalah deskripsi yang akan ditampilkan sebelum (setelah untuk kasus <check>) item (checkbox, opsi multi-select option, dan lain-lain).
Contoh. <check key="lit" text="Lit" default="off" delete_if_empty="true" /> <check key="oneway" text="Oneway" default="off" delete_if_empty="true" /> <combo key="foot" text="Foot" values="yes,designated,official,no">
<label_text= >
text_context="context"
Seperti name_context, atribut ini menyediakan konteks terjemahan. Atribut ini memisahkan atribut text yang memiliki kata yang sama namun memiliki arti yang berbeda.
86 Contoh. <combo key="fuel" text="Fuel" text_context="grill"> values="charcoal,electric,wood" OR <label text="Edit Goods" text_context="aerialway" />
default="default_value"
Merupakan value standar untuk sebuah item. Jika tidak ditentukan, value dari key saat ini dipilih sebagai default (jika berlaku). Lebih sering lagi, default nya bisa menjadi <default=” ” >
Contoh. <combo key="parking" text="Type" values="multi-storey,surface,underground"
default="surface" delete_if_empty="true" /> OR <combo key="park_ride" text="Park and Ride" values="yes,no" default="" delete_if_empty="true" />
delete_if_empty="true"
Jika text (Atau combo) box dibiarkan kosong, maka key nya dihilangkan, bukan memasukkan key dengan value yang kosong. Default nya adalah “false”.
Contoh. <combo key="fee" text="Fee" values="yes,no" default="" delete_if_empty="true" /> OR <check key="motorroad" text="Motorroad" default="off" delete_if_empty="false" /> (This is unnecessary because default is false... )
values="entry1,entry2,entry3"
Sebuah daftar entri (untuk combo box dan multiselect). Daftar ini harus dipisahkan menggunakan koma (untuk combo box) atau oleh pembatas tertentu (untuk multiselect). Jika sebuah value berisi pembatas (pembatas), pembatas tersebut bisa ditutup dengan menggunakan sebuah backlash. Jika sebuah value berisi backlash (/), untuk menutupnya juga harus diakhiri dengan sebuah backlash.
Contoh. <combo key="surface" text="Surface"
values="paved,unpaved,asphalt,concrete,metal,wood,paving_stones,cobblestone,gravel,pebblestone ,compacted,grass_paver,grass,sand,ground">
values_context="context"
Konteks terjemahan untuk nama atribut untuk memisahkan kata yang sama dengan arti yang berbeda (tidak diharuskan untuk terjemahan yang sudah ada di dalam preset).
Contoh. <combo key="location" text="Location" values="underground,underwater,overground" values_context="pipeline" default="" delete_if_empty="true" />
display_values="Entry1,Entry2,Entry3"
Sebuah daftar entri yang diperlihatkan kepada Anda. Harus merupakan nomor yang sama dengan values dan editable harus berupa false atau tidak ditentukan. Untuk delimiter character and escaping, lihat catatan pada values.
value="value"
Menentukan sebuah value yang dimasukkan ke dalam tag <key> . Contoh. <key key="man_made" value="crane" />
value_on="true_value"
Menentukan true value yang dimasukkan ke dalam tag <key> (defaultnya “yes”). value_on: value yang akan diset ketika diceklis (defaultnya “yes”).
87 value_off="false_value"
Menentukan false value yang akan dimasukkan ke dalam tag <key> (defaultnnya “no”). value_off: value yang akan diset ketika tidak diceklis (defaultnya “no”)
editable="false"
Combo box nya adalah read only, yang berarti kita hanya bisa memilih sebuah item dari daftar yang ada.
use_last_as_default="true"
Untuk combo box atau text fields, value terakhir digunakan sebagai default. Gunakan “force” memberlakukannya juga untuk objek yang sudah diberi tag.
Contoh. <text key="addr:street" text="Street name" use_last_as_default="true" delete_if_empty="true" /> OR
<text key="addr:city" text="City name" use_last_as_default="true" delete_if_empty="true" /> OR <text key="addr:postcode" text="Post code" use_last_as_default="true"
delete_if_empty="true" /> OR
<combo key="addr:country" text="Country code" values="AT,CH,DE,FR,GB,IT,US" use_last_as_default="true" delete_if_empty="true" />
required="true"
Preset tidak valid kecuali value untuk key ini sudah dimasukkan. Digunakan oleh Properties Dialog untuk menunjukkan daftar dari preset untuk objek yang dipilih.
Contoh. <combo key="bridge" text="Bridge" values="yes,viaduct,swing,aqueduct" required="true" default="yes" />
rows="count"
<check key="payment:coins" text="Coins" default="off" delete_if_empty="true" /> Menentukan jumlah baris pada entri multiselect.
88
Daftar Istilah
<check> Sebuah kotak-cek (checkbox) dimana pengguna hanya dapat memilih atau tidak memilih
<combo> Menampilkan kotak pilihan ganda. key dan values wajib dituliskan, dan text, default, editable, dan required opsional (tidak harus). Jika editable-nya true (default), maka Kotak pilihan ganda dapat di-edit selayaknya kotak teks (tambahan bagi menu pilihan ke bawah). Kotak pilihan ganda yang tidak bisa diedit hanya bisa memiliki satu dari values/nilai tertentu.
<group> Digunakan untuk group item pada sub menu. name harus ada, icon hanya merupakan atribut pilihan
<item> Setiap item merupakan satu preset yang memungkinkan untuk dipilih. name harus ada, icon hanya merupakan atribut pilihan.
<link> Menambahkan sebuah link website untuk fitur atau hal lainnya. Atribut href wajib dimasukkan.
<multiselect> Menampilkan suatu daftar dari item-item yang dapat dipilih, baik satu atau lebih ataupun tidak dipilih sama sekali.
<text> Sebuah field edit text untuk memasukkan arbitrary string dari pengguna. key wajib dimasukkan, text, default dan required hanya opsional.
Attribute Sebuah informasi yang ada di dalam sebuah tag, seperti name=“Hamburger”
Check Box Sebuah box/kotak yang memungkinkan pengguna untuk membuat beberapa pilihan dari sejumlah pilihan atau untuk memilih jawaban ya (dicentang) atau tidak (tidak dicentang)
Combo Box Sebuah box/kotak yang menggabungkan fitur dari kotak teks dan daftar drop-down. Pengguna dapat memilih salah satu dari berbagai pilihan yang ada pada menu drop-down (pilihan ke bawah). delimiter Sebuah karakter pemisah seperti spasi atau koma yang memisahkan kata-kata ataupun values. Element objek XML apapun, diisi dengan tag pembuka dan penutup, seperti <item> ... data...</item> Key mendefinisikan secara umum mengenai sebuah elemen atau objek.
Map Feature Sebuah halaman web yang berisi tag beserta atribut dan key serta values beserta penjelasannya yang dapat dilihat pada website berikut: http://wiki.openstreetmap.org/wiki/Map_Features
Root
Element Elemen paling penting dari sebuah dokumen XML, yang mendeskripsikan apa yang ada di dalamnya
Tag Sebuah kata kunci atau istilah yang diberikan kepada sebuah objek atau informasi. Tag berisi deskripsi dari sebuah objek dan nantinya dapat ditemukan lagi melalui proses pencarian (search). Sebuah tag terdiri dari Key dan Value yang digunakan untuk mendeskripsikan suatu elemen (titik, gari, dan relasi) atau set perubahan. sesuatu yang terdapat di dalam tanda < >, seperti <item>. < item> adalah tag pembuka pada sebuah elemen, dan </item> adalah tag penutup.
Text Box Sebuah box/kotak yang menampilkan teks yang dapat dimasukkan oleh pengguna atau berasal dari sumber lain untuk tujuan editing.
Value Mencantumkan informasi dari Key sehingga menjadi lebih spesifik
XML Extensible Mark-Up Language. Sebuah bahasa yang mirip dengan HTML. XML didesain untuk membawa data, bukan menampilkannya.
89
