Templat:Peta lokasi/Mencipta definisi peta baharu

Memahami templat definisi peta

Rumpun templat {{peta lokasi}} menggunakan salah satu dari mana-mana set definisi peta. Mereka bukan cabang tetapi laman bantuan dan perlu mempunyai nama mengikut pola "Modul:Peta lokasi/data/lokasi atau "Templat:Peta lokasi lokasi", di mana lokasi ialah nama kawasan yang diliputi oleh peta. Ruang templat disokong hanya untuk keserasian ke belakang; semua definisi peta baharu seharusnya dicipta sebagai modul. Penting: Jika peta baharu mempunyai unjuran dan sempadan yang sama seperti peta lama (contohnya Fail:Iraq location map.svg dan Fail:Iraq location map2.svg), definisi baharu seharusnya tidak dicipta; sebaliknya, definisi lama sepatutnya digunakan dengan parameter AlternativeMap. Untuk mencipta modul definisi peta ringkas menggunakan sebuah imej peta dengan sebuah unjuran Merkator sama segi empat tepat:

1. Sebelum mencipta imej peta baharu, buat carian di Wikimedia commons bagi memastikan peta belum wujud. Jika peta yang dicari belum wujud, bolehlah mencipta imej peta baharu.
2. Cipta sebuah laman modul dengan pola nama "Modul:Peta lokasi/data/lokasi", salin kod di bahagian #Sintaks Lua di bawah, masukkan ke dalam laman modul dan ganti nilai yang sesuai.
3. Cipta pendokumenan modul dan ikut arahan di #Pendokumenan.
4. Cipta sebuah lagi laman modul dengan pola "Modul:Location map/data/location" yang mana location ialah nama lokasi dalam bahasa Inggeris dan salin kod di #Lencongan, masukkan ke dalam laman dan ganti nilai yang sesuai. Laman ini dimaksudkan sebagai lencongan dan bagi memudahkan pengguna membuat carian dengan nama seperti di Wikipedia Bahasa Inggeris.

Contoh

Sebagai contoh, di sini ditunjukkan bagaimana imej peta bagi negara Belgium dicipta. Dalam contoh ini peta menggunakan unjuran sama segi empat tepat. Sila jangan mencuba menggunakan templat yang aktif.

Sintaks Lua

Modul:Peta lokasi/data/Belgium mengandungi sintaks berikut:

return {
	name = 'Belgium',
	top = 51.8,
	bottom = 49.2,
	left = 2.2,
	right = 6.9,
	image = 'Belgium location map.svg',
	image1 = 'Belgium relief location map.jpg'
}

Parameter	Keterangan
name	Nama kawasan yang diliputi
top	Latitud pinggir atas imej menggunakan darjah perpuluhan
bottom	Latitud pinggir bawah imej
left	Longitud pinggir kiri imej
right	Longitud pinggir kanan imej
image	Nama fail imej di Commons
image1	Nama imej alternatif, biasanya peta muka bumi, yang boleh diakses menggunakan parameter relief.

Perhatian:Peta jenis unjuran Merkator hanya sesuai untuk kawasan bersaiz kecil dan sederhana. Modul:Peta lokasi/data/AS Alabama ialah lain contoh keterangan peta yang menggunakan unjuran sama segi empat tepat. Ambil perhatian bahawa imej negara kebanyakannya tidak sama seperti yang dijangka.

Peta yang menggunakan unjuran lain, seperti Modul:Peta lokasi/data/AS, yang menggunakan unjuran kon sama jarak memerlukan formula yang digunakan untuk mengira koordinat x dan y untuk tanda lokasi. Memahami formula tersebut memerlukan pengetahuan dengan subjek dan pada masa ini adalah di luar skop perbincangan ini. Perhatikan bahawa formula untuk x menilai ke 0 untuk pinggir kiri imej dan 100 untuk pinggir kanan. Begitu juga, formula untuk y menilai ke 0 untuk pinggir atas dan 100 untuk pinggir bawah.

Lencongan

Modul:Location map/data/Belgium mengandungi sintaks berikut:

return require {'Modul:Peta lokasi/data/Belgium'}

Pendokumenan

Di sini ialah sebuah contoh bagaimana seharusnya bentuk laman pendokumenan:

<!-- Kategori dan antarawiki di bahagian bawah laman ini. -->
{{Modul:Peta lokasi/data/doc|image=[[File:Belgium-CIA WFB Map.png|thumb|250px|Peta Belgium]]
|examples=
=== Peta lokasi, menggunakan peta tersedia (image) ===
{{Peta lokasi | Belgium
| width   = 200
| lat_deg = 50.85
| lon_deg = 4.35
| label   = Brussels
}}
<pre style="width:30em">
{{Peta lokasi | Belgium
| width   = 200
| lat_deg = 50.85
| lon_deg = 4.35
| label   = Brussels
}}
</pre>
{{kosongkan}}

=== Peta lokasi banyak, menggunakan peta muka bumi (image1) ===
{{Peta lokasi banyak | Belgium
| relief   = yes
| width    = 200
| caption  = Dua lokasi di Belgium
| lat1_deg = 50.85
| lon1_deg = 4.35
| label1   = Brussels
| lat2_deg = 51.22
| lon2_deg = 4.40
| label2   = Antwerp
}}
<pre style="width:30em">
{{Peta lokasi banyak | Belgium
| relief   = yes
| width    = 200
| caption  = Dua lokasi di Belgium
| lat1_deg = 50.85
| lon1_deg = 4.35
| label1   = Brussels
| lat2_deg = 51.22
| lon2_deg = 4.40
| label2   = Antwerp
}}
</pre>
{{kosongkan}}

=== Peta lokasi+, menggunakan AlternativeMap ===
{{Peta lokasi+ | Belgium
| AlternativeMap = Belgium relief location map.jpg
| width   = 200
| caption = Dua lokasi di Belgium
| places  =
  {{Peta lokasi~ | Belgium
  | lat_deg = 50.85
  | lon_deg = 4.35
  | label   = Brussels
  }}
  {{Location map~ | Belgium
  | lat_deg = 51.22
  | lon_deg = 4.40
  | label   = Antwerp
  }}
}}
<pre style="width:35em">
{{Peta lokasi+ | Belgium
| AlternativeMap = Belgium relief location map.jpg
| width   = 200
| caption = Dua lokasi di Belgium
| places  =
  {{Location map~ | Belgium
  | lat_deg = 50.85
  | lon_deg = 4.35
  | label   = Brussels
  }}
  {{Peta lokasi~ | Belgium
  | lat_deg = 51.22
  | lon_deg = 4.40
  | label   = Antwerp
  }}
}}
</pre>
}}
<includeonly>
<!-- Kategori di sini, dan antarawiki di Wikidata: -->

[[Kategori:Templat peta lokasi Belgium|Templat peta lokasi Belgium]]

</includeonly>

Parameter berikut diambil oleh Modul:Peta lokasi/data/doc:

Parameter	Keterangan
image	Imej tambahan untuk dipaparkan (selain dari yang digunakan oleh peta lokasi) di pinggir kanan laman pendokumenan. Jika tidak diperincikan, tiada imej tambahan dipaparkan.
projection	Jenis unjuran yang digunakan oleh peta lokasi. Jika tidak diperincikan, "[[unjuran sama segi empat tepat]]" digunakan.
name	Nama untuk dipaparkan di pendokumenan peta. Jika tidak diperincikan, nama sebenar peta lokasi digunakan.
examples	Bahagian yang mengandungi contoh penggunaan peta lokasi. Templat {{kosongkan}} secara automatik diletakkan di bahagian akhir contoh. Jika tidak diperincikan, tiada contoh dikeluarkan.
see also	Pautan tambahan untuk diletakkan di bahagian "Lihat juga".

Semua maklumat tentang peta akan diambil secara automatik dari definisi peta itu sendiri.