Template:Coord/doc

{{Coord}}模板基于地理坐标及其他参数，提供标准化的坐标表示，并生成指向地图资源清单的链接。该模板主要用于指定地球上的WGS84地理坐标（经度、纬度），同时输出可供机器读取的Geo微格式。此外，它也可用于标注天然卫星、矮行星以及地外行星上的位置。

注意：地球上的坐标使用的大地测量系统必须是WGS84，然而，许多主流地图服务在显示中国大陆地区时加入了偏移。关于如何获取WGS84坐标，详见WP:获取地理坐标。

• 若要指定天体坐标，请改用{{Sky}}。
• 对于缺少坐标（但需要坐标）的条目，请使用{{Coord missing}}标记。
• 如果坐标是由维基数据提供的，请使用{{WikidataCoord}}。

另见：地理坐标专题（英文）。

简明指南

坐标用法速查
要在条目顶端加入57°18′22″N 4°27′32″W，可以这样使用{{Coord}}： {{Coord|57|18|22|N|4|27|32|W|display=title}} 此处的经纬坐标使用角度、分、秒表示法。 “display=title”表示将坐标显示在页面顶部条目标题旁（仅限桌面视图，移动视图中不会显示标题坐标）。 同时该坐标会被记录为维基百科地理搜索API中该条目主题的主要位置。
要在条目顶端加入44.112°N 87.913°W / 44.112; -87.913，可以使用以下两者之一： {{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提供该坐标位置的外部地图服务资源等信息。

对于地球坐标，链接左侧将显示蓝色地球图标（），点击该图标可激活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}}	43.651234°N 79.383333°W / 43.651234; -79.383333	多伦多 - 完整十进制格式（西半球通过负号表示）
{{coord|43.65|-79.38}}	43.65°N 79.38°W / 43.65; -79.38	多伦多 - 低精度十进制
{{coord|43.6500|-79.3800}}	43.6500°N 79.3800°W / 43.6500; -79.3800	多伦多 - 带尾随零的中等精度十进制
{{coord|43.653500|N|79.384000|W}}	43.653500°N 79.384000°W / 43.653500; -79.384000	多伦多 - 带明确半球标识的高精度十进制
{{coord|43|29|N|79|23|W}}	43°29′N 79°23′W	多伦多 - 度、分格式
{{coord|43|29|13|N|79|23|02|W}}	43°29′4″N 79°23′0″W	多伦多 - 度、分、秒格式
{{coord|43|29|12.6|N|79|23|02.4|W}}	43°29′12.6″N 79°23′02.4″W	多伦多 - 度、分、秒及秒的小数格式
{{coord|55.752222|N|37.615556|E}}	55.752222°N 37.615556°E / 55.752222; 37.615556	莫斯科 - 北纬与东经
{{coord|55.752222|N|37.615556|E|format=dms}}	55°45′08″N 37°36′56″E	转换为度分秒格式
{{coord|39.098095|-94.587307|format=dms}}	39°05′53″N 94°35′14″W	不带N/S/E/W标识的十进制转换
{{coord|55.752222|N|37.615556|E|format=dec|name=Moscow}}	55.752222°N 37.615556°E / 55.752222; 37.615556 (Moscow)	转换为十进制并在地图上标注
{{coord|33|55|S|18|25|E}}	33°55′S 18°25′E	开普敦 - 南纬与东经
{{coord|35|00|N|105|00|E}}	35°00′N 105°00′E	中华人民共和国
{{coord|22|54|30|S|43|14|37|W}}	22°54′30″S 43°14′37″W	里约热内卢 - 南纬与西经
{{coord|22|S|43|W}}	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}}	52°28′N 1°55′W	伯明翰 - 带显示参数、注释和参数设置；注意此坐标也会显示在本页顶部
{{coord|51|25.813|N|0|43.945|E}}	51°25.813′N 0°43.945′E	英国梅德韦河上的导航浮标
{{coord|51|36.287|N|8|32.018|W}}	51°36.287′N 8°32.018′W	爱尔兰灯塔委员会定义的旧金塞尔角灯塔

参考資料

辅助函数

当{{Coord}}出现在信息框等容器模板中时，可使用一些辅助函数处理其输出。

从Coord模板中提取经纬度

提取纬度：

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

提取经度：

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

注意：此方法会移除微格式标记，不应在会生成父级微格式的模板（如信息框或表格行模板）中使用。

注意事项

未经讨论不得修改本模板。外部工具可能依赖于其wikitext或生成的HTML。

展开大小限制

含有过多内联坐标的页面可能接近或超过维基百科的展开包含大小限制，此时可考虑改用{{#invoke:Coordinates|coord}}：

• {{Coord|57|18|22|N|4|27|32|W|display=inline}} → 57°18′22″N 4°27′32″W（1544字节）
• {{#invoke:Coordinates|coord|57|18|22|N|4|27|32|W|display=inline}} → 57°18′22″N 4°27′32″W（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}}	46°43′N 7°58′E

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}}	51.500611°N 0.124611°W / 51.500611; -0.124611
威斯敏斯特宫	1:5,000	{{coord|51.5006|N|0.1246|W|scale:5000}}	51.5006°N 0.1246°W / 51.5006; -0.1246
威斯敏斯特市	1:50,000	{{coord|51.501|N|0.125|W|scale:50000}}	51.501°N 0.125°W / 51.501; -0.125
大伦敦	1:500,000	{{coord|51.50|N|0.12|W|scale:500000}}	51.50°N 0.12°W / 51.50; -0.12

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}}	0°N 90°W
俄亥俄州	400公里（250英里）	{{coord|40.5|-82.5|dim:400km}}	40.5°N 82.5°W / 40.5; -82.5
德累斯顿	20,000米（12英里）	{{coord|51.03|13.73|dim:20000}}	51.03°N 13.73°E / 51.03; 13.73
自由女神像	100米（330英尺）	{{coord|40.6892|-74.0445|dim:100}}	40.6892°N 74.0445°W / 40.6892; -74.0445

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}}	46.9524°N 7.4396°E / 46.9524; 7.4396
德国柏林	DE-BE	{{coord|52.5164|N|13.3775|E|region:DE-BE}}	52.5164°N 13.3775°E / 52.5164; 13.3775

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}}	0.4°N 334.6°W / 0.4; -334.6
维京2号着陆器	mars	{{coord|48.269|N|225.990|W|globe:mars}}	48.269°N 225.990°W / 48.269; -225.990
莫扎特陨石坑	mercury	{{coord|7.8|N|190.5|W|globe:mercury}}	7.8°N 190.5°W / 7.8; -190.5
阿波罗11号着陆点	moon	{{coord|0|40|26.69|N|23|28|22.69|E|globe:moon}}	0°40′26.69″N 23°28′22.69″E
克萨陨石坑	titan	{{coord|14.0|N|65.4|W|globe:titan}}	14.0°N 65.4°W / 14.0; -65.4
金星13号着陆器	venus	{{coord|7.5|S|303|E|globe:venus}}	7.5°S 303°E / -7.5; 303
斯蒂克尼陨石坑	phobos	{{coord|1|N|49|W|globe:phobos}}	1°N 49°W

截至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:坐标标签格式错误的页面。目前该分类包含383个页面，具体处理方式请参阅分类说明。

模板数据

由于参数存在重载，本模板与可视化编辑器/模板数据兼容性不佳，建议通过“编辑源代码”而非可视化编辑器修改。

以下是该模板的模板数据，适用于可视化编辑器等工具。

Coord模板数据

用于编码地理位置的经纬度坐标并提供地图链接。本模板不兼容可视化编辑器，使用时需按以下格式之一填写位置参数：{{coord|纬度|经度|坐标参数|模板参数}}、{{coord|度|N/S|度|E/W|坐标参数|模板参数}}、{{coord|度|分|N/S|度|分|E/W|坐标参数|模板参数}}或{{coord|度|分|秒|N/S|度|分|秒|E/W|坐标参数|模板参数}}。

模板参数

参数		描述	类型	状态
1	1	纬度度数或带符号的十进制纬度	数字	推荐
2	2	可以是：纬度分钟数、带符号的十进制经度或N/S	字符串	推荐
3	3	可以是：纬度秒数、经度度数、N/S或GeoHack参数	字符串	可选
4	4	可以是：经度度数、N/S/E/W或GeoHack参数	字符串	可选
5	5	可以是：经度度数、经度分钟数或GeoHack参数	字符串	可选
6	6	可以是：经度分钟数、E/W或GeoHack参数	字符串	可选
7	7	经度秒数或GeoHack参数	字符串	可选
8	8	E或W 推荐值 E W	字符串	可选
9	9	GeoHack参数 示例值 dim:30_region:US-WI_type:event	字符串	可选
维基数据项目	qid	从维基数据项目获取坐标而非模板参数 示例值 Q513	单行文本	可选
显示位置	display	坐标显示位置。可选值：“inline”（正文内）、“title”（页面顶部）或“inline,title”（两者都显示） 推荐值 inline title inline,title 默认值 inline	单行文本	推荐
名称	name	地图上显示的标签（默认为页面名称PAGENAME）	字符串	可选
备注	notes	紧接在坐标后显示的文本	字符串	可选
格式	format	坐标显示格式，可选“dec”（十进制）或“dms”（度分秒） 推荐值 dec dms	单行文本	可选
地理搜索	nosave	设为“true”可避免该坐标被注册到地理搜索API 推荐值 true	字符串	可选