模板:Coord/doc

{{Coord}}模板基於地理坐標及其他參數，提供標準化的坐標表示，並生成指向地圖資源清單的連結。該模板主要用於指定地球上的WGS84地理坐標（經度、緯度），同時輸出可供機器讀取的Geo微格式。此外，它也可用於標註天然衛星、矮行星以及地外行星上的位置。

注意：地球上的坐標使用的大地測量系統必須是WGS84，然而，許多主流地圖服務在顯示中國大陸地區時加入了偏移。關於如何獲取WGS84坐標，詳見WP:獲取地理坐標。

• 若要指定天體坐標，請改用{{Sky}}。
• 對於缺少坐標（但需要坐標）的條目，請使用{{Coord missing}}標記。
• 如果坐標是由維基數據提供的，請使用{{WikidataCoord}}。

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

簡明指南

坐標用法速查
要在條目頂端加入，可以這樣使用{{Coord}}： {{Coord|57|18|22|N|4|27|32|W|display=title}} 此處的經緯坐標使用角度、分、秒表示法。 「display=title」表示將坐標顯示在頁面頂部條目標題旁（僅限桌面視圖，移動視圖中不會顯示標題坐標）。 同時該坐標會被記錄為維基百科地理搜索API中該條目主題的主要位置。
要在條目頂端加入，可以使用以下兩者之一： {{Coord|44.112|N|87.913|W|display=title}} （此格式不需要分秒值，但需用戶指定北/南和東/西方向） 或 {{Coord|44.112|-87.913|display=title}} （此格式中正數表示北緯/東經，負數表示南緯/西經）。 此處坐標使用十進制度度數表示。
度分秒以管道符（「|」）分割。 地球上使用的大地測量系統必須是WGS84。 避免使用過高精度（0.0001°誤差不足11m，1″誤差不足31m）。 保證經緯小數位數一致。 緯度（N/S）要在經度（E/W）前。
以下可選參數跟在經度後，以下劃線（「_」）分割： dim: — 可視半徑，公尺 region: — 區域號，使用ISO 3166-1二位字母代碼或ISO 3166-2地區代碼 type: — 類型，如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}}。 額外指引：獲取坐標、地理坐標轉換。

功能

坐標可以使用適當的精確度以十進位計數法（小數）輸入，或者用度/分/秒參數輸入。預設情況下，坐標將以輸入的格式顯示，也可通過format=參數指定顯示格式。

模板會顯示格式化後的坐標，並帶有指向GeoHack的超連結。GeoHack提供該坐標位置的外部地圖服務資源等資訊。

對於地球坐標，連結左側將顯示藍色地球圖標（File:Erioll world.svg），點擊該圖標可激活WikiMiniAtlas地圖功能（需啟用JavaScript）。

預設情況下，坐標會內嵌顯示在相鄰文本中。但可以通過display=參數將坐標移動至頁面標題附近（僅限桌面視圖，移動視圖不顯示標題坐標），或同時顯示在兩處。

該模板會以三種格式輸出坐標：

• 度/分/秒（「DMS」，顯示精度與輸入精度一致，為度、度/分、或度/分/秒）
• 十進制度（小數位數與輸入精度對應）
• 可供機器讀取的Geo微格式

其他功能：

• 登入用戶可以自訂坐標在其瀏覽器中的顯示方式。
• 若不提供任何匿名參數，可從維基數據自動獲取坐標。
• 可從Coord模板中提取數據進行數學運算，詳見Module:Coordinates。
• 所有通過本模板標記的坐標將自動註冊至地理搜索API。設為標題顯示的坐標將被標記為條目主坐標，代表該主題的地理位置。

用法

可選擇以下四種格式之一：

{{coord|纬度|经度|坐标参数|模板参数}}
{{coord|度|N/S|度|E/W|坐标参数|模板参数}}
{{coord|度|分|N/S|度|分|E/W|坐标参数|模板参数}}
{{coord|度|分|秒|N/S|度|分|秒|E/W|坐标参数|模板参数}}

• 使用十進制度表示時，可省略「N/S」（北緯/南緯）和「E/W」（東經/西經）的半球標識，此時正值表示北緯/東經，負值表示南緯/西經
• 使用度分秒格式時，度、分、秒必須為正值，且必須包含半球標識。半球標識必須緊貼管道符「|」，前後不得有空格。

以下兩類參數均為可選：

• 坐標參數是傳遞給地圖服務的參數。格式為「參數:值」，各參數之間用下劃線（_）分隔。支持的坐標參數包括：dim:、globe:、region:、scale:、source:和type:。完整的用法及範例詳見下文。
• 模板參數是模板自身使用的參數。格式為「參數=值」，各參數之間用管道符（|）分隔。支持的模板參數包括：display=、format=、name=和notes=。

• display= 控制顯示位置，可設置為以下值之一：

• display=inline – 預設值，以內嵌形式顯示坐標
• display=title – 將坐標顯示在條目頂部、標題旁（僅桌面視圖可見，移動視圖不顯示標題坐標）
  • 簡寫：display=t
• display=inline,title – 同時以內嵌和標題形式顯示坐標
  • 簡寫：display=it
• display=title,inline 與 display=inline,title 效果相同

注意：title表示坐標適用於整個條目，而不僅僅是條目中提到的某個（或多個）地點。標題顯示的坐標會在地理搜索API中被標記為條目的主要坐標，代表該條目主題的位置。

• format= 強制使用十進制（dec）或度分秒（dms）格式顯示坐標。

• format=dec 將坐標格式化為十進制度。
• format=dms 將坐標格式化為度|分|秒格式。

• name= 當坐標對象與條目名稱不符時，為內嵌顯示的坐標指定名稱，供WikiMiniAtlas等地圖服務顯示。如果省略，未指定名稱時預設使用條目標題（PAGENAME）。名稱應使用純文本，避免加入代碼。

注意：設置了name=參數會使{{Coord}}生成一個使用該名稱的hCard微格式，即使該模板已經嵌套在其他hCard中也會生成。因此不要在人名（例如墓地名稱）中使用，以免生成無效hCard。同時名稱中請勿使用方括號。

• notes= 緊接坐標後顯示的文本，主要用於給顯示在標題旁的坐標添加註腳。
• qid= 指定要顯示其坐標的維基數據QID，主要用於使用維基數據的資訊框。

在同一張地圖上顯示所有坐標連結

模板{{GeoGroup}}和{{Maplink}}可用於含有坐標的條目中。{{GeoGroup}}會生成連結，指向某個地圖服務，在同一張地圖上顯示所有坐標，並提供其他服務將這些坐標以KML或GPX格式使用或下載。{{Maplink}}則會添加一個連結或嵌入式mapframe，能夠顯示頁面或某一章節中所有具名坐標（即使用|name=參數的{{coord}}模板）。

範例

{{coord|43.651234|-79.383333}}		多倫多 - 完整十進制格式（西半球通過負號表示）
{{coord|43.65|-79.38}}		多倫多 - 低精度十進制
{{coord|43.6500|-79.3800}}		多倫多 - 帶尾隨零的中等精度十進制
{{coord|43.653500|N|79.384000|W}}		多倫多 - 帶明確半球標識的高精度十進制
{{coord|43|29|N|79|23|W}}		多倫多 - 度、分格式
{{coord|43|29|13|N|79|23|02|W}}		多倫多 - 度、分、秒格式
{{coord|43|29|12.6|N|79|23|02.4|W}}		多倫多 - 度、分、秒及秒的小數格式
{{coord|55.752222|N|37.615556|E}}		莫斯科 - 北緯與東經
{{coord|55.752222|N|37.615556|E|format=dms}}		轉換為度分秒格式
{{coord|39.098095|-94.587307|format=dms}}		不帶N/S/E/W標識的十進制轉換
{{coord|55.752222|N|37.615556|E|format=dec|name=Moscow}}		轉換為十進制並在地圖上標註
{{coord|33|55|S|18|25|E}}		開普敦 - 南緯與東經
{{coord|35|00|N|105|00|E}}		中華人民共和國
{{coord|22|54|30|S|43|14|37|W}}		里約熱內盧 - 南緯與西經
{{coord|22|S|43|W}}		一個經緯度交匯點
{{coord|52|28|N|1|55|W|region:GB_type:city|notes=<ref>{{cite web|url=http://www.fallingrain.com/world/UK/0/Birmingham.html|title=Birmingham}}</ref>|display=inline,title}}		伯明翰 - 帶顯示參數、註釋和偏好設定；注意此坐標也會顯示在本頁頂部
{{coord|51|25.813|N|0|43.945|E}}		英國梅德韋河上的導航浮標
{{coord|51|36.287|N|8|32.018|W}}		愛爾蘭燈塔委員會定義的舊金塞爾角燈塔

參考資料

輔助函數

當{{Coord}}出現在資訊框等容器模板中時，可使用一些輔助函數處理其輸出。

從Coord模板中提取經緯度

提取緯度：

{{#invoke:coordinates|coord2text|{{Coord|57|18|22|N|4|27|32|E}}|lat}} →

提取經度：

{{#invoke:coordinates|coord2text|{{Coord|57|18|22|N|4|27|32|E}}|long}} →

注意：此方法會移除微格式標記，不應在會生成父級微格式的模板（如資訊框或表格行模板）中使用。

注意事項

未經討論不得修改本模板。外部工具可能依賴於其wikitext或生成的HTML。

展開大小限制

含有過多內嵌坐標的頁面可能接近或超過維基百科的展開包含大小限制，此時可考慮改用{{#invoke:Coordinates|coord}}：

• {{Coord|57|18|22|N|4|27|32|W|display=inline}} → （1544位元組）
• {{#invoke:Coordinates|coord|57|18|22|N|4|27|32|W|display=inline}} → （772位元組）

移動端可見性

坐標的預設顯示方式為|display=inline（內嵌顯示），如果設置為|display=title（僅標題顯示），則移動視圖中不會顯示坐標。

坐標參數

經度後的第一個匿名參數是可選的坐標參數字串，用下劃線分隔。這些參數幫助GeoHack選擇合適的地圖資源，在Wikimaps完全啟用後將更加重要。

type:類型

type: 參數指定地理對象的類型，用於反向製圖（例如在WikiMiniAtlas中選擇標記圖標）。

設置類型的同時還將自動設定地圖的比例尺，但可以通過dim:或scale:參數覆蓋。

有效的類型包括：

type:	描述	地圖比例尺
adm1st	國家一級行政區（省、州），如美國州份	1:1,000,000
adm2nd	國家二級行政區，如縣 (美國)	1:300,000
adm3rd	國家三級行政區	1:100,000
airport	機場和空軍基地	1:30,000
city(pop)	已知人口的城市、鎮、村、聚落、郊區、分區、社區等人類聚居地（包括未建制或已廢棄的） 請將pop替換為具體人口數。千位分隔符會被忽略，不要有空格。	1:30,000 ... 1:300,000
city	未指定人口的城市、鎮、村等人類聚居地（包括未建制或已廢棄的） 此類按小型城市處理。	1:100,000
country	國家	1:10,000,000
edu	學校、學院和大學	1:10,000
event	特定地點發生的單次或周期性事件，包括戰役、地震、節日、沉船等	1:50,000
forest	森林和林地	1:50,000
glacier	冰川和冰蓋	1:50,000
isle	島嶼	1:100,000
landmark	建築物（含教堂、工廠、博物館、劇院、發電站等，不含學校與火車站）、洞穴、墓地、文化地標、地質斷層、海角、交叉路口、礦山、牧場、道路、構築物（含天線、橋樑、城堡、水壩、燈塔、紀念碑、體育場等）、旅遊景點、山谷及其他興趣點	1:10,000
mountain	山峰、山脈、丘陵、暗礁和海山	1:100,000
pass	山口	1:10,000
railwaystation	鐵路車站與設施（含鐵路、地鐵、輕軌、高架鐵路等的車站、站點及維修區）	1:10,000
river	河流、運河、溪流等（包括季節性河道）	1:100,000
satellite	地球同步衛星	1:10,000,000
waterbody	海灣、峽灣、湖泊、水庫、池塘、濱海湖、河口、內海與瀑布	1:100,000
camera	表示特定照片的拍攝位置，用於檔案頁面的坐標模板	1:10,000
	預設比例尺：未使用類型或GeoHack擴展中未定義類型時使用	1:300,000

範例

type:	標記	效果
waterbody	{{coord|46|43|N|7|58|E|type:waterbody}}

scale:比例

scale:參數以1:N形式指定所需的地圖比例尺，覆蓋任何type:參數隱含的比例尺。

GeoHack使用scale:按72dpi顯示器選擇地圖比例尺。若未設定dim:、type:或scale:參數，GeoHack使用預設比例尺1:300,000。

範例

主題	scale:	標記	結果
大本鐘	1:500	{{coord|51.500611|N|0.124611|W|scale:500}}
威斯敏斯特宮	1:5,000	{{coord|51.5006|N|0.1246|W|scale:5000}}
威斯敏斯特市	1:50,000	{{coord|51.501|N|0.125|W|scale:50000}}
大倫敦	1:500,000	{{coord|51.50|N|0.12|W|scale:500000}}

dim:周邊區域直徑

dim:參數定義以坐標為中心的可視區域直徑，影響外部地圖初始縮放比例。單位預設為米，也可加後綴km表示公里。

GeoHack使用dim:選擇地圖比例尺，使可視區域在72dpi顯示器上顯示約10厘米（4吋）直徑。如未提供dim:、type:或scale:參數，GeoHack預設使用30公里（19哩）觀察圈。

範例

主題	dim:	標記	結果
西半球	10,000公里（6,200哩）	{{coord|0|N|90|W|dim:10000km}}
俄亥俄州	400公里（250哩）	{{coord|40.5|-82.5|dim:400km}}
德累斯頓	20,000米（12哩）	{{coord|51.03|13.73|dim:20000}}
自由女神像	100米（330呎）	{{coord|40.6892|-74.0445|dim:100}}

region:地區

region:參數指定地球上坐標所屬的行政區域，用於選擇合適的地圖資源。如未提供，GeoHack會嘗試根據坐標自動判斷。

區域代碼應採用ISO 3166-1二位字母代碼或ISO 3166-2地區代碼。

ISO 3166-1二位字母代碼代碼範例：

• AQ：南極洲
• AU：澳大利亞
• BR：巴西
• DE：德國
• GB：英國
• HK：香港
• IN：印度
• LK：斯里蘭卡
• RU：俄羅斯
• US：美國

ISO 3166-2地區代碼範例：

• DE-TH：德國圖林根州
• GB-BIR：英格蘭伯明翰
• NO-03：挪威奧斯陸
• US-NY：美國紐約州

根據德語維基百科的說明，對於海洋，維基百科使用以下專用代碼：

• XN：北冰洋
• XA：大西洋
• XI：印度洋
• XP：太平洋
• XS：南冰洋

此外，{{coord}}可使用兩個維基專用代碼：

• XZ 國際水域物體（類似UN/LOCODE）
• ZZ 範例專用

範例

焦點區域	區域代碼	標記	結果
瑞士	CH	{{coord|46.9524|N|7.4396|E|region:CH}}
德國柏林	DE-BE	{{coord|52.5164|N|13.3775|E|region:DE-BE}}

globe:天體名稱

globe:參數指定坐標所在的行星、矮行星、小行星或天然衛星。除預設值earth（地球）外，有效值包括：mercury、venus、moon、mars、phobos、deimos、ceres、vesta、jupiter、ganymede、callisto、io、europa、mimas、enceladus、tethys、dione、rhea、titan、hyperion、iapetus、phoebe、miranda、ariel、umbriel、titania、oberon、triton、pluto、charon。

範例

主題	globe:	標記	結果
基圖隕石坑	ganymede	{{coord|0.4|N|334.6|W|globe:ganymede}}
維京2號着陸器	mars	{{coord|48.269|N|225.990|W|globe:mars}}
莫扎特隕石坑	mercury	{{coord|7.8|N|190.5|W|globe:mercury}}
阿波羅11號着陸點	moon	{{coord|0|40|26.69|N|23|28|22.69|E|globe:moon}}
克薩隕石坑	titan	{{coord|14.0|N|65.4|W|globe:titan}}
金星13號着陸器	venus	{{coord|7.5|S|303|E|globe:venus}}
斯蒂克尼隕石坑	phobos	{{coord|1|N|49|W|globe:phobos}}

截至2021年2月，GeoHack為幾乎所有支持的星體提供粗略地圖，WikiMiniAtlas系統為月球、火星、水星、金星、木衛一和土衛六提供有限地圖支持。

這些地圖隱含坐標系參考系統但未明確指定（不同於地球的WGS84）。由於模板預設使用東經，對於使用西經的星體必須指定|W|方向。天體坐標請使用{{Sky}}模板。

source:來源

用於標註數據來源及其格式/基準面（可選擇包含原始數據，置於括號內）。主要供地理標記機械人使用，以避免數據在格式轉換和跨維基複製過程中丟失精度和來源資訊。

範例：

• 從英語維基百科OS國家網格參考NM 435 355轉換而來的坐標應標記為：「source:enwiki-osgb36(NM435355)」
• 源自德語維基百科的坐標標記為：「source:dewiki」（其他語言代碼類推）
• 來自公共數據庫GEOnet名稱服務的坐標標記為：「source:GNS」。由於維基坐標預設採用WGS84基準面的經緯度格式，此類來源無需額外說明基準面。同理，美國GNIS數據庫來源標記為「source:GNIS」

用戶個性化顯示設置

若需始終以度分秒格式顯示坐標，請將以下代碼添加至您的common.css檔案：

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

若需始終以十進制格式顯示坐標，請將以下代碼添加至您的common.css檔案：

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

若需同時顯示兩種坐標格式，請將以下代碼添加至您的common.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緩存為舊版本，您將同時看到兩種格式的坐標。（可通過清除緩存或手動刷新此連結解決：[1]）

如需隱藏坐標旁的藍色地球圖標，請將以下代碼添加至您的common.js檔案：

var wma_settings = {enabled:false}

注意：此操作將同時禁用WikiMiniAtlas功能。

錯誤檢測與維護分類

本模板內置了錯誤檢測機制。多數錯誤會顯示加粗紅色的提示資訊，並將頁面歸入隱藏的維護分類Category:坐標標籤格式錯誤的頁面。目前該分類包含0個頁面，具體處理方式請參閱分類說明。

模板資料

由於參數存在重載，本模板與視覺化編輯器/模板資料兼容性不佳，建議通過「編輯原始碼」而非視覺化編輯器修改。

以下是該模板的模板資料，適用於視覺化編輯器等工具。

Coord模板資料

<templatedata>{ "description": "用於編碼地理位置的經緯度坐標並提供地圖連結。本模板不兼容視覺化編輯器，使用時需按以下格式之一填寫位置參數：、、或。", "params": { "1": { "label": "1", "description": "緯度度數或帶符號的十進制緯度", "type": "number", "required": false, "suggested": true }, "2": { "label": "2", "description": "可以是：緯度分鐘數、帶符號的十進制經度或N/S", "type": "string", "required": false, "suggested": true }, "3": { "label": "3", "description": "可以是：緯度秒數、經度度數、N/S或GeoHack參數", "type": "string", "required": false }, "4": { "label": "4", "description": "可以是：經度度數、N/S/E/W或GeoHack參數", "type": "string", "required": false }, "5": { "label": "5", "description": "可以是：經度度數、經度分鐘數或GeoHack參數", "type": "string", "required": false }, "6": { "label": "6", "description": "可以是：經度分鐘數、E/W或GeoHack參數", "type": "string", "required": false }, "7": { "label": "7", "description": "經度秒數或GeoHack參數", "type": "string", "required": false }, "8": { "label": "8", "description": "E或W", "type": "string", "required": false, "suggestedvalues": [ "E", "W" ] }, "9": { "label": "9", "description": "GeoHack參數", "type": "string", "required": false, "example": "dim:30_region:US-WI_type:event" }, "qid": { "label": "維基數據專案", "description": "從維基數據專案獲取坐標而非模板參數", "type": "line", "required": false, "example": "Q513" }, "display": { "label": "顯示位置", "description": "坐標顯示位置。可選值：「inline」（正文內）、「title」（頁面頂部）或「inline,title」（兩者都顯示）", "type": "line", "default": "inline", "suggested": true, "required": false, "suggestedvalues": [ "inline", "title", "inline,title" ] }, "name": { "label": "名稱", "description": "地圖上顯示的標籤（預設為頁面名稱PAGENAME）", "type": "string", "required": false }, "notes": { "label": "備註", "description": "緊接在坐標後顯示的文本", "type": "string", "required": false }, "format": { "label": "格式", "description": "坐標顯示格式，可選「dec」（十進制）或「dms」（度分秒）", "type": "line", "required": false, "suggestedvalues": [ "dec", "dms" ] }, "nosave": { "label": "地理搜索", "description": "設為「true」可避免該坐標被註冊到地理搜索API", "type": "string", "required": false, "suggestedvalues": [ "true" ] } } }</templatedata>