模板:Location map/Creating a new map definition

本指南解釋了如何為{{Location map}}系列模板創建地圖定義。

地圖定義數據

這些模板可以使用任何一個地圖定義。這些地圖定義並非分支，而是輔助頁面，其名稱必須遵循「Module:Location map/data/location」（模組）或「Template:Location map location」（模板）的模式。其中，位置是地圖覆蓋區域的名稱。模板空間僅用於向後兼容；所有新的地圖定義都應創建為模組。重要提示：如果新地圖與舊地圖具有相同的投影和邊界（例如File:Iraq location map.svg和File:Iraq location map2.svg），則不應創建新定義；而應使用舊定義並啟用AlternativeMap參數。要使用以赤道為標準緯線的等距長方投影地圖圖像創建簡單的地圖定義模組（也稱為等距方陣投影、「未投影」、經緯度投影）：

1. 創建一張新的地圖圖片並上傳到維基共享資源，或在同一網站上找到現有地圖。
2. 創建一個名為「Module:Location map/data/location」的模組，複製下面的內容並替換相應的值。
3. 創建一個名為「Module:Location map/data/location/doc」的頁面，按照文檔下的說明操作。

作為使用等距長方投影的地圖示例，我們使用模組:Location map/data/Belgium。請不要嘗試使用主動模板。

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'
}

參數	描述
name	該名稱涵蓋的地區
top	圖像上緣的緯度，以十進制數表示
bottom	圖像下緣的緯度
left	圖像左緣的經度
right	圖像右緣的經度
image	共享資源中圖片文件的名稱
image1	一張替代圖像的名稱，通常是起伏圖，可通過relief參數操作。

這類地圖適合中小型區域。Module:Location map/data/USA Alabama是另一個使用等距長方投影的地圖描述示例。請注意，這個國家的圖象並非大多數人所預期的那樣。

高級投影

使用其他投影的地圖，如Module:Location map/data/USA，採用等距圓錐投影。需要計算位置標記x和y坐標的公式。理解這些公式需要熟悉相關學科，因此你可以跳過這一部分。

輸入$1為緯度，$2為經度，均為十進制形式。該表達式遵循[[解析函數「#expr」的語法。兩個輸出坐標定義為x的公式對圖像左邊為0，右邊為100；y的公式對上邊為0，下邊為100。

文檔

使用Template:Location map data documentation中的事實模板生成文檔頁面是最簡單的。這裏還有一個可能的文檔示例：

<!-- Categories and interwikis go at the bottom of this page. -->
{{Location map data documentation|image=[[File:Belgium-CIA WFB Map.png|thumb|250px|比利时地图]]
|examples=
=== 位置地图，采用默认地图 (图像) ===
{{Location map | Belgium
| width   = 200
| lat_deg = 50.85
| lon_deg = 4.35
| label   = 布鲁塞尔
}}
<pre style="width:30em">
{{Location map | Belgium
| width   = 200
| lat_deg = 50.85
| lon_deg = 4.35
| label   = 布鲁塞尔
}}
</pre>
{{clear}}

=== Location map many, using relief map (image1) ===
{{Location map many | Belgium
| relief   = yes
| width    = 200
| caption  = 比利时的两个地点
| lat1_deg = 50.85
| lon1_deg = 4.35
| label1   = 布鲁塞尔
| lat2_deg = 51.22
| lon2_deg = 4.40
| label2   = 安特卫普
}}
<pre style="width:30em">
{{Location map many | Belgium
| relief   = yes
| width    = 200
| caption  = 比利时的两个地点
| lat1_deg = 50.85
| lon1_deg = 4.35
| label1   = 布鲁塞尔
| lat2_deg = 51.22
| lon2_deg = 4.40
| label2   = 安特卫普
}}
</pre>
{{clear}}

=== Location map+, using AlternativeMap ===
{{Location map+ | Belgium
| AlternativeMap = Belgium relief location map.jpg
| width   = 200
| caption = 比利时的两个地点
| places  =
  {{Location map~ | Belgium
  | lat_deg = 50.85
  | lon_deg = 4.35
  | label   = 布鲁塞尔
  }}
  {{Location map~ | Belgium
  | lat_deg = 51.22
  | lon_deg = 4.40
  | label   = 安特卫普
  }}
}}
<pre style="width:35em">
{{Location map+ | Belgium
| AlternativeMap = Belgium relief location map.jpg
| width   = 200
| caption = 比利时的两个地点
| places  =
  {{Location map~ | Belgium
  | lat_deg = 50.85
  | lon_deg = 4.35
  | label   = 布鲁塞尔
  }}
  {{Location map~ | Belgium
  | lat_deg = 51.22
  | lon_deg = 4.40
  | label   = 安特卫普
  }}
}}
</pre>
}}
<includeonly>
<!-- Categories go here, and interwikis go on Wikidata: -->

[[Category:比利时位置图模板|Belgium location map templates]]

</includeonly>

模板參數

此頁面是一個模板，用於生成名稱以「Module:Location map/data/」開頭的地理位置圖數據模組的文檔，例如模塊：Module:Location map/data/Morocco。它使用每個模塊的文檔頁面，例如Module:Location map/data/Morocco/doc。

參數

Template:Location map data documentation採用以下參數：

參數	描述
image	要在文檔頁面右側顯示的附加圖像（地理位置圖使用的圖像除外）。如未指定，則不顯示附加圖像。
projection	地理位置圖使用的投影類型。如未指定，則使用"等距矩形投影"。
name	要在地圖文檔中顯示的名稱。默認情況下，該名稱未連結條目。如未指定，則使用地理位置圖的實際名稱。
examples	包含地理位置圖用法示例的部分。{{clear}}模板會自動放置在示例的末尾。如未指定，則不輸出任何示例。
see also	放置在「另請參閱」部分中的其他連結。

有關地圖的所有信息都將自動從地圖的定義本身獲取。

子地圖列表

Special:前綴索引/Module:Location map/data/