Templat:Peta lokasi

Pendokumenan templatlihatsuntingsejarahnyahcache

class=notpageimage|

Lokasi Kuala Lumpur di Malaysia

Templat {{Peta lokasi}} digunakan bagi menjana suatu peta lokasi sebagai suatu imej komposit, yang terdiri daripada peta dan tanda lokasi. Secara pilihan, label dan kapsyen juga boleh ditambah.

Penggunaan

Fail-fail imej peta tidak dicapai secara terus, tetapi dengan menggunakan takrifan peta tambahan. Contohnya, jika parameter tidak bernama pertama yang diberikan untuk templat ini ialah Jepun, maka templat ini menggunakan masukan untuk Jepun di Modul:Peta lokasi/data/Jepun (kalau modul ini wujud), yang menggunakan data yang diperlukan untuk menjana imej komposit.

Sila ambil perhatian

• Menetapkan mana-mana nilai kepada parameter |kapsyen= menyebabkan peta akan dipaparkan sebagai suatu imej lakaran kecil. Jika parameter ini tidak disediakan, templat akan menjana kapsyen lalai.
• Periksa koordinat terlebih dahulu. Jika koordinat yang ditentukan berada di luar kawasan cakupan imej peta, tanda lokasi tidak akan dipaparkan di dalam imej. Walau bagaimanapun, imej itu mungkin ditunjukkan di tempat lain pada laman tersebut.
• Harap tidak menggunakan px apabila menetapkan saiz imej peta. Penggunaan |lebar=200px biasanya akan menyebabkan paparan peta yang amat besar. Jadi, gunakan |lebar=200.
• Untuk menghasilkan peta dengan lebih daripada satu tanda lokasi, sila gunakan {{Peta lokasi+}} atau {{Peta lokasi banyak}}.

Templat kosong

Sila salin sintaks kosong di bawah dan tampalkannya di laman rencana yang berkaitan. Kesemua parameter kecuali {{{1}}} di dalam templat ini adalah pilihan. Sebarang parameter yang tidak digunakan harus ditinggalkan, tetapi juga boleh dibiarkan kosong jika diingini.

Senarai templat kosong

Darjah perpuluhan	Darjah, minit, saat	Dengan {{koord}} (biasanya untuk kotak info)	Wikidata
{{Peta lokasi | {{{1}}} | lebar = | penjajaran = | sempadan = | kapsyen = | alt = | peta_bentuk_muka_bumi = | peta_alternatif = | imej_tindanan = | label = | saiz_label = | kedudukan = | latar_belakang = | tanda = | saiz_tanda = | pautan = | lat-darjah = | long-darjah = }}	{{Peta lokasi | {{{1}}} | lebar = | penjajaran = | sempadan = | kapsyen = | alt = | peta_bentuk_muka_bumi = | peta_alternatif = | imej_tindanan = | label = | saiz_label = | kedudukan = | latar_belakang = | tanda = | saiz_tanda = | pautan = | lat-darjah = | lat-minit = | lat-saat = | lat-arah = | long-darjah = | long-minit = | long-saat = | long-arah = }}	{{Peta lokasi | {{{1}}} | lebar = | penjajaran = | sempadan = | kapsyen = | alt = | peta_bentuk_muka_bumi = | peta_alternatif = | imej_tindanan = | label = | saiz_label = | kedudukan = | latar_belakang = | tanda = | saiz_tanda = | koordinat = }}	{{Peta lokasi | {{{1}}} | lebar = | penjajaran = | sempadan = | kapsyen = | alt = | peta_bentuk_muka_bumi = | peta_alternatif = | imej_tindanan = | label = | saiz_label = | kedudukan = | latar_belakang = | tanda = | saiz_tanda = }}

Parameter dan data templat

Ini ialah TemplateData untuk templat ini yang digunakan oleh TemplateWizard, VisualEditor dan alatan-alatan lain. Lihat laporan penggunaan parameter bulanan untuk Template:Peta lokasi.

TemplateData untuk Peta lokasi

TemplateData

Templat ini digunakan untuk menghasilkan peta lokasi.

Parameter templat[Sunting data templat]

Parameter		Keterangan	Jenis	Status
Nama lokasi	{{{1}}}	Nama peta untuk digunakan pada parameter tidak bernama ini. Berbilang nama boleh diletakkan dengan menggunakan simbol "#" sebagai pemisah.	Rentetan	diperlukan
Lebar peta	lebar	Menentukan lebar peta dalam piksel, yang akan menggantikan nilai lalai. Jangan masukkan "px" pada parameter. Contohnya, masukkan nilai "300", bukannya "300px". Tersedia 240	Angka	disarankan
Penjajaran peta	penjajaran	Penjajaran kedudukan peta pada suatu laman. Nilainya yang sah ialah "left" (kiri), "right" (kanan), "center" (tengah) dan "none" (tiada). Nilai yang dicadangkan left right center none Tersedia right	Baris	pilihan
Gaya sempadan bingkai peta	sempadan	Warna sempadan bingkai peta. Jika ditetapkan pada "none" (tiada), tiada sempadan akan dijana. Nilai yang dicadangkan none infobox lightgrey Tersedia lightgrey	Baris	pilihan
Kapsyen peta	kapsyen	Teks kapsyen yang akan dipaparkan di bawah peta. Jika kapsyen ditakrifkan tetapi tidak diberikan nilai, peta tidak akan dibingkaikan dan tiada kapsyen akan dipaparkan. Jika kapsyen tidak ditakrifkan, peta tidak akan dibingkaikan dan kapsyen lalai akan dijana.	Rentetan	disarankan
Teks silihan peta	alt alternatif	Teks silihan untuk peta. Digunakan untuk pembaca dengan masalah penglihatan yang tidak dapat melihat peta dan teks itu menggantikan peranannya.	Rentetan	disarankan
Peta bentuk muka bumi	peta_bentuk_muka_bumi relief	Peta alternatif yang ditentukan dalam templat takrifan peta sebagai imej1, dengan memasukkan apa-apa nilai bukan kosong (contohnya: "1", "yes"). Kebiasaannya, parameter ini diisi dengan peta bentuk muka bumi (peta relief). Nilai berangka lain seperti 2 atau 3 akan memaparkan imej2 atau imej3, jika imej tersebut ditakrifkan. Nilai yang dicadangkan 1 2 3 yes	Baris	pilihan
Peta alternatif	peta_alternatif	Membenarkan penggunaan peta alternatif; imej mesti mempunyai koordinat sisian yang sama seperti templat peta lokasi.	Fail	pilihan
Imej tindanan	imej_tindanan	Membenarkan imej tindanan untuk ditindihkan pada peta.	Rentetan	pilihan
Label penanda	label	Teks label yang akan dipaparkan di sebelah penanda yang ditentukan. Pautan wiki boleh digunakan pada parameter ini.	Baris	disarankan
Saiz label peta	saiz_label	Saiz fon yang digunakan untuk label. Jangan masukkan nilai "%" pada parameter. Contohnya, masukkan nilai "75", bukannya "75%". Tersedia 91	Angka	pilihan
Lebar label peta	lebar_label	Lebar untuk digunakan bagi label, dengan menggunakan saiz em. Jangan masukkan nilai "em" pada parameter. Contohnya, masukkan nilai "7", bukannya "7em". Tersedia 6	Angka	pilihan
Kedudukan label	kedudukan	Kedudukan relatif label terhadap penanda. Nilai yang dicadangkan left right top bottom none Tersedia right	Baris	pilihan
Warna latar belakang label	latar_belakang	Warna latar belakang untuk label.	Baris	pilihan
Penanda peta	tanda	Nama fail imej untuk dipaparkan sebagai penanda pada peta. Awalan "Fail:" tidak diperlukan. Contohnya, masukkan nilai "Red pog.svg", bukannya "Fail:Red pog.svg". Tersedia Red Dot.svg	Fail	disarankan
Saiz penanda peta	saiz_tanda	Saiz penanda pada peta dalam piksel. Jangan masukkan "px" pada parameter. Contohnya, masukkan nilai "10", bukannya "10px". Tersedia 8	Angka	disarankan
Pautan penanda	pautan	Pautan wiki yang boleh dicapai jika pembaca mengklik pada penanda.	Nama laman	pilihan
Koordinat	koordinat	Koordinat penuh untuk menentukan kedudukan penanda pada peta. Parameter ini hendaklah digunakan bersama dengan templat {{Koord}}. Contoh {{Koord|48.067|12.863}}	Rentetan	pilihan
Darjah latitud	lat-darjah	Darjah bagi latitud (garis lintang). Nilai ini hendaklah ditentukan dengan menggunakan format darjah perpuluhan, dan apabila format ini digunakan, minit dan saat tidak boleh ditentukan.	Angka	diperlukan
Minit latitud	lat-minit	Minit bagi latitud. Gunakan parameter ini jika tidak menggunakan format darjah perpuluhan.	Angka	pilihan
Saat latitud	lat-saat	Saat bagi latitud. Gunakan parameter ini jika tidak menggunakan format darjah perpuluhan.	Angka	pilihan
Arah latitud	lat-arah	Arah bagi latitud. Nilai yang dibenarkan hanyalah "N" untuk Utara dan "S" untuk Selatan daripada garisan Khatulistiwa. Parameter ini tidak diperlukan apabila menggunakan format darjah perpuluhan. Nilai yang dicadangkan N S Tersedia N	Baris	pilihan
Darjah longitud	long-darjah	Darjah bagi longitud (garis bujur). Nilai ini hendaklah ditentukan dengan menggunakan format darjah perpuluhan, dan apabila format ini digunakan, minit dan saat tidak boleh ditentukan.	Angka	diperlukan
Minit longitud	long-minit	Minit bagi longitud. Gunakan parameter ini jika tidak menggunakan format darjah perpuluhan.	Angka	disarankan
Saat longitud	long-saat	Saat bagi longitud. Gunakan parameter ini jika tidak menggunakan format darjah perpuluhan.	Angka	pilihan
Arah longitud	long-arah	Arah bagi longitud. Nilai yang dibenarkan hanyalah "E" untuk Timur dan "W" untuk Barat daripada garisan meridian perdana. Parameter ini tidak diperlukan apabila menggunakan format darjah perpuluhan. Nilai yang dicadangkan W E Tersedia E	Baris	disarankan

Peta yang tersedia

• Khas:Indeks awalan/Modul:Peta_lokasi/data/ – Senarai modul peta lokasi yang telah dicipta. Sila semak di pautan ini terlebih dahulu sebelum mencipta modul baharu.
• Templat:Peta lokasi/Senarai – Beberapa item yang disenaraikan di sini adalah lencongan, dan ada daripadanya mungkin tidak berfungsi seperti yang dijangka.
• Kategori:Templat peta lokasi – Templat yang diisih mengikut kategori.
• Khas:Pautan ke sini/Templat:Peta lokasi/Info – Carian yang mungkin membantu.
• Khas:Indeks awalan/Templat:Peta lokasi – Satu lagi carian yang mungkin membantu.

Mencipta takrifan peta baharu

Sila lihat laman Mencipta takrifan peta baharu.

Contoh penggunaan

Lebar dan penjajaran lalai, tiada label dan kapsyen lalai (koordinat perpuluhan)

• Catatan: Apabila suatu label tidak ditentukan, kapsyen lalainya ialah "Nama laman (Nama peta)". Jika contoh ini dipaparkan pada laman bernama Muara Besar, kapsyen lalainya ialah "Muara Besar (Brunei)". Begitu juga, pada laman bernama Muara Besar (pulau), kapsyen lalainya ialah "Muara Besar (pulau) (Brunei)".

Peta lokasi (Brunei)

{{Peta lokasi | Brunei
 | alt                   = Muara Besar ialah sebuah pulau
 | lat-darjah            = 5.0060444
 | long-darjah           = 115.0999753
}}

Peta dengan kapsyen lalai (darjah, minit dan saat)

• Catatan: Apabila suatu label ditentukan, kapsyen lalainya ialah "Teks label (Nama peta)", seperti yang dilihat sebagai "Muara Besar (Brunei)" dalam contoh ini.

Muara Besar

Muara Besar (Brunei)

{{Peta lokasi | Brunei
 | lebar                 = 260
 | penjajaran            = right
 | alt                   = Muara Besar ialah sebuah pulau
 | label                 = Muara Besar
 | kedudukan             = left
 | tanda                 = City locator 0 green.svg <!-- titik hijau -->
 | saiz_tanda            = 12
 | lat-darjah            = 5
 | lat-minit             = 0
 | lat-saat              = 21.76 <!-- lalai: lat_arah = N -->
 | long-darjah           = 115
 | long-minit            = 5
 | long-saat             = 59.91 <!-- lalai: long-arah = E -->
}}

Peta di luar sempadan peta, tiada kapsyen

Ba'kelalan

{{Peta lokasi | Brunei
 | lebar                 = 260
 | penjajaran            = right
 | kapsyen               = 
 | alt                   = Ba'kelalan di Sarawak, Malaysia (di luar peta)
 | label                 = Ba'kelalan
 | kedudukan             = left
 | lat-darjah            = 3.995556 <!-- di luar had sempadan bawah peta pada 3.9 -->
 | long-darjah           = 115.6225 <!-- di luar had sempadan kanan peta pada 115.5 -->
 | luar                  = 1 <!-- kami sedar bahawa titik itu berada di luar peta, jadi sekat kategori amaran -->
}}

Dengan kapsyen, saiz label, latar belakang, penanda, saiz penanda

Ba'kelalan

class=notpageimage|

Lokasi Ba'kelalan di Malaysia Timur

{{Peta lokasi | Malaysia Sarawak
 | lebar                 = 260
 | penjajaran            = right
 | kapsyen               = Lokasi Ba'kelalan di Malaysia Timur
 | alt                   = Peta Sarawak dengan penanda menunjukkan lokasi Ba'kelalan
 | label                 = Ba'kelalan
 | saiz_label            = 130 <!-- 130% daripada saiz biasa -->
 | kedudukan             = bottom
 | latar_belakang        = #F58331AB <!-- dengan kelegapan -->
 | tanda                 = Orange pog.svg
 | saiz_tanda            = 10 <!-- saiz dalam piksel -->
 | lat-darjah            = 3.995556 
 | long-darjah           = 115.6225 
}}

Dengan parameter peta alternatif

Ba'kelalan

class=notpageimage|

Lokasi Ba'kelalan di Malaysia Timur

{{Peta lokasi | Utara Borneo
 | peta_alternatif       = Location map Malaysia Borneo.png
 | lebar                 = 260
 | penjajaran            = right
 | kapsyen               = Lokasi Ba'kelalan di Malaysia Timur
 | alt                   = Peta Sarawak dengan penanda menunjukkan lokasi Ba'kelalan
 | label                 = Ba'kelalan
 | latar_belakang        = #F5F3DAAB <!-- dengan kelegapan -->
 | lat-darjah            = 3.995556 
 | long-darjah           = 115.6225 
}}

Parameter peta bentuk muka bumi (peta relief)

• Dengan |peta_bentuk_muka_bumi= tidak mempunyai nilai, imej yang ditakrifkan oleh modul akan dipaparkan. Nilai-nilai berangka 1 hingga 99 akan menunjukkan imej1 hingga imej99. Apa-apa nilai lain akan menunjukkan imej1.
  Contoh-contoh berikut juga memaparkan kedudukan label automatik di sebelah kiri disebabkan oleh kedudukan tanda paling kanan.

Tanjung Guardafui

class=notpageimage|

Lokasi Tanjung Guardafui di Afrika

{{Peta lokasi | Afrika
 | peta_bentuk_muka_bumi = yes
 | kapsyen               = Lokasi Tanjung Guardafui di Afrika
 | label                 = Tanjung Guardafui
 | lebar_label           = 9
 | lat-darjah            = 11.833333
 | long-darjah           = 51.283333
}}

• Peta bentuk muka bumi kedua daripada Modul:Peta lokasi/data/Afrika boleh digunakan dengan menetapkan |peta_bentuk_muka_bumi=2.

Tanjung Guardafui

class=notpageimage|

Lokasi Tanjung Guardafui pada peta litupan tanah penyelakuan Afrika

{{Peta lokasi | Afrika
 | peta_bentuk_muka_bumi = 2
 | kapsyen               = Lokasi Tanjung Guardafui pada peta litupan tanah penyelakuan Afrika
 | label                 = Tanjung Guardafui
 | lebar_label           = 9
 | lat-darjah            = 11.833333
 | long-darjah           = 51.283333
}}

Paparan berbilang peta

Lapangan Terbang Paris Charles de Gaulle

class=notpageimage|

Lapangan Terbang Paris Charles de Gaulle

Lapangan Terbang Paris Charles de Gaulle

class=notpageimage|

Lapangan Terbang Paris Charles de Gaulle

{{Peta lokasi | Perancis Île-de-France#Perancis
 | penjajaran            = right
 | kapsyen               = Lapangan Terbang Paris Charles de Gaulle
 | label                 = Lapangan Terbang Paris Charles de Gaulle
 | latar_belakang        = #F5F3DAAB
 | tanda                 = Airplane silhouette.svg
 | saiz_tanda            = 15
 | lat-darjah            = 48.9821188
 | long-darjah           = 2.4852198
}}

Peta yang melintasi meridian 180°

• Berikut merupakan contoh di mana lokasi peta itu melintasi meridian 180°.

Suva

Suva (Fiji)

{{Peta lokasi | Fiji
 | lebar                 = 180
 | penjajaran            = right
 | label                 = Suva
 | kedudukan             = right
 | latar_belakang        = yellow
 | tanda                 = Locator_Dot.png
 | saiz_tanda            = 8
 | lat-darjah            = 18
 | lat-minit             = 8
 | lat-saat              = 0
 | lat-arah              = S
 | long-darjah           = 178
 | long-minit            = 26
 | long-saat             = 0
 | long-arah             = E
}}

Uelen

class=notpageimage|

Lokasi Uelen di Rusia

{{Peta lokasi | Rusia
 | lebar                 = 270
 | penjajaran            = right
 | kapsyen               = Lokasi Uelen di Rusia
 | peta_bentuk_muka_bumi = yes
 | label                 = Uelen
 | kedudukan             = bottom
 | latar_belakang        = lightgreen
 | tanda                 = Locator_Dot.png
 | saiz_tanda            = 7
 | lat-darjah            = 66
 | lat-minit             = 9
 | lat-arah              = N
 | long-darjah           = 169
 | long-minit            = 48
 | long-arah             = W
}}

Lihat juga

Untuk contoh-contoh yang serupa, sila lihat pendokumenan di

• {{Peta lokasi+}}, untuk memaparkan bilangan penanda dan label tanpa had

• {{Peta lokasi+/relief}}, contoh yang menggunakan parameter |peta_bentuk_muka_bumi=.
• {{Peta lokasi+/Peta alternatif}}, contoh yang menggunakan parameter |peta_alternatif=.
• {{Peta lokasi+/tindanan}}, contoh yang menggunakan parameter |imej_tindanan=.

• {{Peta lokasi banyak}}, untuk memaparkan sehingga 9 penanda dan label

Pendokumenan di atas ditransklusikan daripada Templat:Peta lokasi/doc. (sunting | sejarah)
Penyunting boleh membuat percubaan di laman kotak pasir (sunting | beza) dan kes ujian (cipta) templat ini.
Sila letakkan kategori di sublaman /doc. Sublaman templat ini.