Wikiwisata:Maptool

Ini adalah perkakas JavaScript berbasis peta yang membantu menemukan POI untuk artikel sekaligus menyiapkan peta dinamisnya. Intinya, alat ini akan meminta Wikidata dan/atau OpenStreetMap untuk berbagai data seputar artikel saat ini, dan menampilkan peta serta tabel yang berisi hasilnya.

Alur kerja yang diharapkan adalah membuka artikel saat ini dalam dua tab: satu untuk maptool, dan satu lagi untuk mengedit artikel guna menambahkan POI yang ditemukan. Seringkali, pengguna cukup menulis templat senarai, seperti berikut:

{{listing | name = Kastil Loket | wikidata = Q1013039}}

tambahkan sedikit konten, dan tempel ke dalam artikel:

{{see | name = Kastil Loket | wikidata = Q1013039 | content = Kastil Gotik abad ke-12 yang terletak di atas batu besar. | url = https://www.hradloket.cz/en/}}

Jadi pengguna tidak perlu lagi mengambil koordinat, mencari gambar, dan lain-lain.

Fungsi dasar

Dengan mengklik ikon perkakas () jendela dialog kueri utama akan terbuka, yang terbagi menjadi beberapa grup dasar:

Tampilkan: Opsi pada baris tersebut memilih hasil yang akan ditampilkan setelah kueri diterapkan. Peta selalu ditampilkan dengan gagang pengubah ukuran opsional diaktifkan di kanan bawah peta. Ini memungkinkan penyiapan pembuatan bingkai peta dengan dimensi yang ditentukan. Terakhir, secara tetapan tabel dengan hasil kueri juga diaktifkan.
Area kueri: Memungkinkan pengguna memilih area melingkar di sekitar koordinat yang ditentukan, atau area persegi panjang yang ditentukan oleh sudut Barat Daya dan Timur Lautnya. Ukuran maksimum yang diizinkan adalah radius 100 km atau jarak diagonal 200 km, untuk membatasi beban server. Namun, perhatikan ukuran area yang dikueri - untuk beberapa negara, mungkin POI yang ada jumlahnya lebih sedikit dibangding negara lain yang jumlahnya bisa mencapai ribuan.
Wikidata dan OpenStreetMap: mencentang salah satu dari keduanya akan mengaktifkan kueri yang menggunakan parameter masing-masing berbeda. Lihat di bawah.
Kueri dan tampilkan akan meminta POI dari server dan setelah data diterima, akan menampilkannya. Di sebelah tombol, parameter {{mapframe}} akan dicetak sebagai kode sumber templat, yang dapat ditempelkan ke dalam artikel.

Catatan: semua komunikasi dilakukan oleh peramban web pengguna sendiri, sehingga Anda (sebagai pengguna) bertanggung jawab untuk tidak menyebabkan kelebihan beban pada server. Harap usahakan untuk meminimalkan ukuran kueri seminimal mungkin dan secara umum, lakukan kueri dengan hati-hati.

Setelah kueri selesai, peta dan/atau tabel hasil akan ditampilkan.

Menggerakkan peta secara otomatis akan mengisi sudut barat daya/timur laut di Area kueri, begitu pula dengan mengubah ukuran peta. Mengklik peta akan mengatur pusat pada opsi Radius di Area kueri.

Wikidata

Mengkuerikan Wikidata adalah cara termudah untuk menambahkan POI. Tersedia pilihan berikut:

Bahasa Wikipedia: Dengan memilih bahasa, Anda hanya dapat menemukan POI yang memiliki artikel Wikipedia dalam bahasa tersebut. Ingatlah bahwa memasukkan string kosong akan mencari semua entri Wikidata (dengan atau tanpa artikel Wikipedia). Ini mungkin lebih menguntungkan atau kurang menguntungkan, tergantung pada cakupan wilayah Wikipedia. Sebagian besar hasil biasanya ditampilkan dalam bahasa lokal - perlu diingat bahwa Wikipedia tidak menggunakan 'pintasan' yang sama dengan domain internet. Misalnya, bahasa Ceko bukan 'cz' melainkan 'cs', Denmark adalah 'da', bukan 'dk', dll.
Urutkan berdasarkan jumlah penayangan Wikipedia Ketika POI Wikidata yang ditemukan memiliki artikel Wikipedia (dalam bahasa yang ditentukan), rata-rata jumlah penayangan bulanan halaman tersebut juga akan ditampilkan (selama setahun terakhir). Angka ini digunakan untuk mengurutkan hasil berdasarkan relevansi. Hal ini dapat menyederhanakan pencarian POI yang relevan - biasanya objek wisata utama memiliki lebih banyak tampilan daripada, misalnya, berbagai fitur alam lokal.
Filter: Hasil Wikidata diperoleh melalui kueri SPARQL. Untuk menghindari tempat yang membosankan, perkakas ini secara tetapan beberapa hasil akan difilter. Filter manual SPARQL tetapan akan menghapus semua hasil yang (singkatnya) memiliki tipe atau subtipe bencana. Kueri yang jauh lebih kompleks juga bisa dilakukan, perlu diingat bahwa khususnya bagian rekursif '/P279*' dapat memperpanjang kueri secara signifikan.

Setelah kueri selesai, peta akan berisi POI yang ditemukan - POI dengan jumlah tampilan yang banyak akan berwarna 'merah muda', yang secara bertahap memudar menjadi abu-abu. Mengklik POI akan menampilkan ID/nama Wikidata, deskripsi singkat Wikidata, tautan artikel Wikipedia, dan gambar - semuanya bergantung pada keberadaan data masing-masing dalam item Wikidata. Ikon POI dipilih secara manual agar sesuai dengan properti 'adalah' Wikidata (P31) dari POI. Informasi ini tidak lengkap dan belum tentu akurat.

Tabel yang dihasilkan umumnya berupa representasi tekstual dari peta. Selain itu, tabel ini berisi jumlah tayangan artikel, serta teks templat {{listing}} yang telah disiapkan dan siap ditempelkan ke dalam artikel. Kemungkinan type=see, type=do, atau argumen lain perlu ditulis manual, begitu pula deskripsi, dll.

OpenStreetMap

Saat ini, fitur ini hanya akan berguna untuk area dengan cakupan Wikidata yang kurang lengkap. Bahkan di area tersebut, OSM biasanya masih memiliki banyak fitur yang tersedia menggunakan bahasa kueri Overpass. Oleh karena itu, kuerinya perlu ditulis dengan lebih hati-hati, terutama karena saat ini tidak ada kriteria pengurutan yang dapat digunakan.

Filter yang disediakan berlaku untuk 'simpul' dan 'jalur' OSM (alias titik, garis, dan area tunggal). Selain kategori yang disediakan (semoga jelas), kolom AUX memungkinkan penambahan satu filter tambahan. ['tourism'~'attraction'] default akan mencari semua POI OSM yang memiliki tag 'tourism' yang disetel ke 'attraction'. Untuk mencari semua POI yang memiliki tag tourism, cukup tentukan ['tourism']. Saat ini, ini adalah kompleksitas maksimum kueri yang diharapkan.

Peta yang dihasilkan berisi nama POI di OSM, serta menghasilkan kode templat {{listing}}, serta bentuk tekstual dari semua tag POI.

Tabel yang dihasilkan sebagian besar hanya berisi nama POI dan senarai templat.