模板:Coord/doc

此頁面是Template:Coord的模板文件。
此頁面可能包含了模板的使用說明、分類和其他內容。

此模板文件被引用於260,000+個頁面。
為了避免造成大規模的影響，所有對此模板文件的編輯應先於沙盒、測試樣例或您的沙盒上測試。
測試後無誤的版本可以一次性地加入此模板文件中，但是修改前請務必於討論頁發起討論。

模板引用數量會自動更新。

{{coord}}模板根基於地理坐標及其他參數，生成一個前往地圖資源清單的鏈接，並提供一個標準化的坐標表示法。

此模板要用地球上的WGS84地理坐標（經度、緯度），坐標可以使用適當的精確度以十進位計數法（小數）輸入，或者用度/分/秒參數輸入。本模板鏈接到//toolserver.org/~geohack/geohack.php?language=zh&pagename=Template:Coord/doc&params= ，並顯示坐標值。點擊其中的藍色星球會激活WikiMiniAtlas地圖顯示（需要Javascript）。

注意：中國大陸地區的商業地形圖坐標都加了偏移，建議優先使用OpenStreetMap坐標。（右鍵「顯示地址」即可讀出。）如要使用Google或Bing的數據，請使用衛星地圖中的坐標。百度地圖和Google.cn的衛星圖也都有偏移，應避免使用。地形圖中的坐標由於使用的是來自於中國大陸廠商提供的坐標數據，已經根據中國政府的要求人工偏移。要將這類坐標修正為WGS84，可以使用User:Artoria2e5/Gadget-PRCoords.js小工具或其線上版本（請使用帶cai的高精度解）；其中大部分地圖使用的是GCJ-02偏移算法，百度地圖用的則是BD-09。

坐標用法速查閱論編
要在條目頂端加入Lua錯誤：callParserFunction: function "#coordinates" was not found。，可以這樣使用 {{Coord}}： `{{Coord\|57\|18\|22\|N\|4\|27\|32\|W\|display=title}}` 此處的經緯坐標使用角度、分、秒表示法。 "display=title" 表示將坐標顯示在條目標題旁。
要在條目頂端加入 Lua錯誤：callParserFunction: function "#coordinates" was not found。，可以使用以下兩者之一： `{{Coord\|44.112\|N\|87.913\|W\|display=title}}` 或 `{{Coord\|44.112\|-87.913\|display=title}}` 此處坐標使用小數度數表示。
度分秒以豎線 ("\|")分割。地球上使用的大地測量系統必須是WGS84。避免使用過高精度（英語：Wikipedia:WikiProject Geographical coordinates#Precision guidelines）（0.0001° 誤差不足 11m，1″ 誤差不足 31 m）。保證經緯小數位數一致。緯度（N/S）要在經度（E/W）前。
以下可選參數跟在經度後，以下劃線（"_"）分割： dim: `dim:`N（可視半徑，公尺） region: `region:`R（區域號，使用ISO 3166-1二位字碼或ISO 3166-2） type: `type:`T (類型，如`landmark`、`city(30,000)`）以下可選參數使用豎線（"\|"）分割： display `\|display=inline`（默認）只和文字顯示在一起 `\|display=title` 只在標題旁顯示 `\|display=inline,title` 兩處都顯示 name `name=`X 可以制定地圖上坐標點的名稱（默認為PAGENAME）例如：`{{Coord\|44.117\|-87.913\|dim:30_region:US-WI_type:event` `\|display=inline,title\|name=事故地点}}` `\|display=title` 和 `\|display=inline,title` 用於條目所表述的對象，只應在條目中出現一次。
按WP:ORDER，坐標模板置於導航模板後, 頁面分類和{{Defaultsort}}前。欲知詳細用法，請讀{{Coord/doc}}。額外指引：獲取坐標（英語：Wikipedia:Obtaining geographic coordinates）、地理坐標轉換（英語：Geographic coordinate conversion）。

若使用其他的角度單位，請參看以下轉換表：

相同角度的轉換表
角度單位	值
轉	$\mathbf {0}$	${\tfrac {1}{12}}$	${\tfrac {1}{8}}$	${\tfrac {1}{6}}$	${\tfrac {1}{4}}$	${\tfrac {1}{2}}$	${\tfrac {3}{4}}$	$\mathbf {1}$
角度	0°	30°	45°	60°	90°	180°	270°	360°
弧度	$\mathbf {0}$	${\tfrac {\pi }{6}}$	${\tfrac {\pi }{4}}$	${\tfrac {\pi }{3}}$	${\tfrac {\pi }{2}}$	$\pi$	${\tfrac {3\pi }{2}}$	$2\pi$
梯度	$0^{g}$	$33{\tfrac {1}{3}}^{g}$	$50^{g}$	$66{\tfrac {2}{3}}^{g}$	$100^{g}$	$200^{g}$	$300^{g}$	$400^{g}$

本模板的輸出數據以下列形式提供：

度/分/秒（「DMS」，精確度是度、或度/分、或度/分/秒，基於輸入值）。一些從十進制（小數的）度到度分秒的換算需要修正（參見英文討論）。
小數（精確度由小數位數確定，基於輸入值）。
地理信息。

Google地球等不少程序都會解析維基百科的數據庫轉儲文件，尋找{{coord}}中的坐標信息。為了確認坐標被正確地解析，一定要使用display=title。參見如何讓我的維基百科條目出現在谷歌地球地理網絡層？。一定不要未經預先討論就匆忙修改本模板。

另請參見地理坐標專題（英文）。

取代對象

這個單一的模板將取代以下模板：

{{coor dms}}
Geolinks模板
Mapit模板

所有參數能夠像以前一樣使用，參見用法。

舉例：

模板編碼	被取代模板編碼
{{coord\|12\|N\|45\|W\|display=title}}	{{coor title d\|12\|N\|45\|W}}
{{coord\|12\|34\|N\|45\|33\|W\|display=title}}	{{coor title dm\|12\|34\|N\|45\|33\|W}}
{{coord\|12\|34\|56\|N\|45\|33\|22\|W\|display=title}}	{{coor title dms\|12\|34\|56\|N\|45\|33\|8\|W}}
{{coord\|12\|34\|12\|N\|45\|33\|45\|W\|display=inline,title}}	{{coor at dms\|12\|34\|12\|N\|45\|33\|45\|W}}
{{coord\|10.2\|-20.3\|display=inline}} 或 {{coord\|10.2\|-20.3}}	{{coor d\|10.2\|N\|-20.3\|E}}
{{coord\|44.4\|-111.1\|type:city_region:US\|display=inline,title}}	{{Geolinks-US-cityscale\|44.4\|-111.1}}
{{coord\|51.01234\|-1.56789\|type:landmark_region:GB\|display=inline,title}}	{{Geolinks-UK-buildingscale\|51.01234\|-1.56789}}
{{coord\|-35.5\|150.1\|type:landmark_region:AU\|display=inline,title}}	{{Mapit-AUS-suburbscale\|lat=-35.5\|long=150.1}}
{{coord\|12\|34\|12\|N\|45\|33\|45\|W\|display=title}}	{{CoorHeader\|12\|34\|12\|N\|45\|33\|45\|W}}

用法

{{coord|latitude|longitude|coordinate parameters|template parameters}}
{{coord|dd|N/S|dd|E/W|coordinate parameters|template parameters}}
{{coord|dd|mm|N/S|dd|mm|E/W|coordinate parameters|template parameters}}
{{coord|dd|mm|ss|N/S|dd|mm|ss|E/W|coordinate parameters|template parameters}}

有兩類參數，都是可選的：

坐標參數：以地圖服務器識別，以參數:值的格式給出，並且藉由下劃線字符「_」互相隔開。常見的坐標參數包括'type、region、和scale。參見坐標參數查看全面的列表。
模板參數：為模板自身所使用，以參數=值的格式給出，並且由管道符「|」互相隔開。支持的模板參數有display、name和format。
- display可以為下列之一：
  - display=inline — 內聯（inline）顯示坐標（缺省值）
  - display=title — 顯示坐標在條目標題旁邊（取代{{coor title dms}}模板家族），快捷方式為display=t
  - display=inline,title — 同時內聯顯示和在標題處顯示坐標（取代{{coor at dms}}模板家族）
    注意：使用title屬性表明坐標適用於該條目，而不只是適用於條目中提及的某一個地點（可能提及了許多地點）——因此該屬性只能在後一種情形下才應當省略。display=title,inline也是有效的。快捷方式為display=it
- format可以用來強制顯示dec或dms坐標給所有讀者。
- name可以用來注釋內聯坐標，用於在地圖服務或其他外部用途中的顯示。它不應用到條目標題旁，或顯示於一個信息框內部的那些坐標，由於在那些情況下條目標題就是隱含的名稱。

舉例

`{{coord\|43.651234\|-79.383333}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	多倫多 - 全小數 - N & W
`{{coord\|43.65\|-79.38}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	多倫多 - 更小精確度
`{{coord\|43.6500\|-79.3800}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	多倫多 - 中等精確度，帶尾隨零
`{{coord\|43.651234\|N\|79.383333\|W}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	多倫多 - 小數，帶北向緯度差與西向經度差（N & W）
`{{coord\|43\|29\|N\|79\|23\|W}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	多倫多 - 度數與分數
`{{coord\|43\|29\|4\|N\|79\|23\|0\|W}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	多倫多 - 度數、分數與秒數
`{{coord\|43\|29\|4.5\|N\|79\|23\|0.5\|W}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	多倫多 - 度數、分數與秒數（小數）
`{{coord\|55.752222\|N\|37.615556\|E}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	莫斯科 - N & E
`{{coord\|55.752222\|N\|37.615556\|E\|format=dms}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	轉換至dms格式
`{{coord\|39.098095\|-94.587307\|format=dms}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	十進制轉換，不帶N/S/E/W
`{{coord\|55.752222\|N\|37.615556\|E\|format=dec\|name=Moscow}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	轉換至十進制，並在某些地圖上貼上標籤
`{{coord\|33\|55\|S\|18\|25\|E}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	開普敦 - S & E
`{{coord\|35\|00\|N\|105\|00\|E}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	中華人民共和國
`{{coord\|22\|54\|30\|S\|43\|14\|37\|W}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	里奧（Rio） - S & W
`{{coord\|22\|S\|43\|W}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	一處經緯匯合
`{{coord\|52\|28\|59\|N\|1\|53\|37\|W\|display=inline,title\|region:GB_type:city}}`	Lua錯誤：callParserFunction: function "#coordinates" was not found。	伯明翰(英國) - 帶顯示及參數設定；注意在本頁的標題處也會顯示

坐標參數

跟隨地理坐標之後，更多參數可能選擇性地提供，它們由下劃線分隔。這會幫助找到適當的地圖資源，當Wikimaps變得完全泛函化（become fully functional）時這一點也會變得更加重要。

type:T

設定這個位置的類型，它將用於小數點的反向映射（the reverse mapping of the points）。類型也將設定缺省地圖比例。如果缺省地圖比例不適當，可考慮添加一個scale:N參數。類型有：

類型（Type）	描述（Description）	比例尺（Scale）
country	(例如 "type:country")	1:10,000,000
satellite	地球同步衛星	(1:10,000,000)
adm1st	國家行政區劃，第一級（省、州），參見table，例如美國州份	1:1,000,000
adm2nd	國家行政區劃，第二級，參見table，例如縣 (美國)	1:300,000
city(pop)	市、鎮或村，帶指定的人口。pop中的逗號會受到忽略。不能有空白。	1:30,000 ... 1:300,000
city	市、鎮或村，未特別指定人口。會被當作一個較小的城市。	1:100,000
airport	機場	1:30,000
mountain	山峰、山脈	1:100,000
isle	島、島嶼	1:100,000
waterbody	灣、海灣、湖、水庫、池塘、港灣、瀉湖、河口灣、內海……	1:100,000
forest	森林、林地	1:50,000
river	江河、運河	1:100,000
glacier	冰川、冰冠	1:50,000
edu	學校、學院、大學	1:10,000
pass	山口	1:10,000
railwaystation	軌道、列車、鐵路、地鐵、高速交通、遂道、高架鐵道，等等	1:10,000
landmark	文化地標、特別有趣的建築、遊覽勝地及其他有趣的地點	1:10,000
	缺省比例尺：如果沒有使用type參數，或者此type在geohack擴展中未定義。	1:300,000

圓括號中的比例尺在geohack擴展中尚未定義。type:state已從列表中撤出。

示例：

{{coord|46|43|N|7|58|E|type:mountain}} 給出 Lua錯誤：callParserFunction: function "#coordinates" was not found。

scale:N

設定想要的地圖比例尺為1:N。這會覆蓋由type:T參數確定的比例尺。若未定義type和scale參數，則使用擴展中的缺省的比例尺（1:300,000）。 scale:為可選參數。

示例
比例尺	標記	結果
1:1000	{{coord\|51.500611\|N\|0.124611\|W\|scale:1000}}	Lua錯誤：callParserFunction: function "#coordinates" was not found。
1:10,000	{{coord\|51.500611\|N\|0.124611\|W\|scale:10000}}	Lua錯誤：callParserFunction: function "#coordinates" was not found。
1:100,000	{{coord\|51.500611\|N\|0.124611\|W\|scale:100000}}	Lua錯誤：callParserFunction: function "#coordinates" was not found。
1:1,000,000	{{coord\|51.500611\|N\|0.124611\|W\|scale:1000000}}	Lua錯誤：callParserFunction: function "#coordinates" was not found。

若前往地圖站點的鏈接在{{GeoTemplate}}中正確配置，並且某個地圖在該比例尺下是可用的，則一個對應的地圖可能顯示出來。

region:R

設置首選的地圖區域覆蓋範圍，用於為該地區選擇適當的地圖資源。若未提供region參數，geohack擴展會嘗試從坐標值來確定它。

區域應當以下列形式給出：一個雙字符的ISO 3166-1國家代碼，或者一個ISO 3166-2區域代碼。例如：

US 美國
US-NY 美國紐約
CA 加拿大
DE 德國
DE-TH 德國圖林根
CH 瑞士
FR 法國
CN 中國

GB 英國
IN 印度
BR 巴西
AU 澳大利亞
NO-03 挪威奧斯陸
NL 荷蘭
LK 斯里蘭卡
TW-TPE 台北市

示例：

{{coord|46.9524|N|7.4396|E|region:CH}} 聚焦於瑞士區域，在 Lua錯誤：callParserFunction: function "#coordinates" was not found。。
{{coord|52.5164|N|13.3775|E|region:DE-BB}} 聚焦於德國區域，在 Lua錯誤：callParserFunction: function "#coordinates" was not found。。

特種碼：

XZ用於國際海域之內/之上的對象（類似於UN/LOCODE）
ZZ用於示例中

globe:G

指定除了地球（Earth）之外的其他行星，例如月球（Moon）、火星（Mars）、金星（Venus）、水星（Mercury）。

Geohack擴展的大部分特性對於其他星球來說不是很理想的。

source:S

指定（此處出現的）數據源和數據源格式/數據，並且可以選擇性地在括號中顯示原始數據。這最初主要是為地理標籤機器人的應用而準備的，以便數據不被盲目地從格式到格式、從Wikipedia到Wikipedia重複拷貝，那會逐步喪失精度與歸屬性。

舉例：

一個源於英國地形測量局（Ordnance Survey）英國國家格網參考系統（British national grid reference system）NM 435 355，其數據發現於英語維基百科，這樣的經/緯地理標籤應當標記為「source:enwiki-osgb36(NM435355)」。
一個源於取自德語維基百科的數據的經度-緯度位置，應當標記為「source:dewiki」。對於其他語言代碼也類似。
一個源於公眾領域地理網絡名稱服務器數據庫的位置應標記為「source:GNS」。數據或格式信息不是必需的，因為缺省情況下所有維基百科坐標都是以基於WGS84數據的經度/緯度格式存在。類似地，源於相似的公眾領域GNIS數據庫的美國位置應當標記為「source:GNIS」。

顯示

缺省情況下坐標以那些指定的格式顯示。

若要總是顯示坐標為度分秒值，添加以下代碼到你的monobook.css：

.geo-default { display: inline } .geo-nondefault { display: inline } 
.geo-dec { display: none }   .geo-dms { display: inline }

若要總是顯示坐標為十進制值，添加以下代碼到你的monobook.css：

.geo-default { display: inline } .geo-nondefault { display: inline }
.geo-dec { display: inline } .geo-dms { display: none }

若要同時以兩種格式顯示坐標，添加以下代碼到你的monobook.css：

.geo-default { display: inline } .geo-nondefault { display: inline }
.geo-dec { display: inline }   .geo-dms { display: inline }
.geo-multi-punct { display: inline }

如果CSS遭到禁用，或者你有一個被緩存的舊版MediaWiki:Common.css，你將同時看到兩種格式。（Common.css的緩存需要31天到期。你可以清空你的緩存，或者手動刷新這個URL：[1]。）

另見en:Wikipedia:Manual of Style (dates and numbers)#Geographical coordinates。

錯誤使用維護

本模板有幾個內建的輸入檢查。基本的錯誤會顯示{{Coord/input/error2}}中的信息。參見Category:需要修復的經緯模板引用查看需要修復的頁面。

子模板

參見Category:經緯模板以及本模板的討論頁。

名稱	功能
Coord/input/d	對以度格式輸入的坐標進行轉換{{coord\|12\|N\|12\|W}}
Coord/input/dm	對以度/分格式輸入的坐標進行轉換{{coord\|12\|12\|N\|12\|12\|W}}
Coord/input/dms	對以度/分/秒格式輸入的坐標進行轉換{{coord\|12\|12\|12\|N\|12\|12\|12\|W}}
Coord/display/inline	創建以內聯形式顯示坐標的輸出
Coord/display/title	創建在條目上方顯示坐標的輸出（通常在條目標題的右側）
Coord/display/inline,title	創建以內聯形式顯示同時在條目上方顯示坐標的輸出

類名

類名geo、latitude和longitude用來生成微格式，並且一定不要更改。

外部鏈接

如何讓我的維基百科條目出現在谷歌地球地理網絡層？——關於Google如何使用維基百科的坐標信息的FAQ

提供WGS84坐標鏈接。

模板參數
此模板以參數行內格式為優先。
參數		描述	類型	狀態
未指定參數

模板編碼	被取代模板編碼
{{coord\|12\|N\|45\|W\|display=title}}	{{coor title d\|12\|N\|45\|W}}
{{coord\|12\|34\|N\|45\|33\|W\|display=title}}	{{coor title dm\|12\|34\|N\|45\|33\|W}}
{{coord\|12\|34\|56\|N\|45\|33\|22\|W\|display=title}}	{{coor title dms\|12\|34\|56\|N\|45\|33\|8\|W}}
{{coord\|12\|34\|12\|N\|45\|33\|45\|W\|display=inline,title}}	{{coor at dms\|12\|34\|12\|N\|45\|33\|45\|W}}
{{coord\|10.2\|-20.3\|display=inline}} 或 {{coord\|10.2\|-20.3}}	{{coor d\|10.2\|N\|-20.3\|E}}
{{coord\|44.4\|-111.1\|type:city_region:US\|display=inline,title}}	{{Geolinks-US-cityscale\|44.4\|-111.1}}
{{coord\|51.01234\|-1.56789\|type:landmark_region:GB\|display=inline,title}}	{{Geolinks-UK-buildingscale\|51.01234\|-1.56789}}
{{coord\|-35.5\|150.1\|type:landmark_region:AU\|display=inline,title}}	{{Mapit-AUS-suburbscale\|lat=-35.5\|long=150.1}}
{{coord\|12\|34\|12\|N\|45\|33\|45\|W\|display=title}}	{{CoorHeader\|12\|34\|12\|N\|45\|33\|45\|W}}