编辑“︁Template:Location map+/doc”︁

{{NoteTA|G1=MediaWiki}}
<!-- 在这里加入模板的标识 -->
{{Documentation subpage}}
<!-- 在本行下編輯模板說明 -->
{{High-use|4107}}
{{Lua|Module:Location map/multi}}
{{Location map+|England|width=300|AlternativeMap=England_locator_map_with_North_East_England_highlighted.svg|alt=Map of England showing the locations of towns and battles. Bosworth is in the centre, northwest of London.|float=right|caption=<span style="font-size:95%;">[[File:Battle icon active (crossed swords).svg|16px|link=]] [[博斯沃思原野戰役]] [[File:Battle icon (crossed swords).svg|14px|link=]] 其他戰役</span> |places=
  {{Location map~ |England |label='''[[博斯沃思原野戰役|博斯沃思]]''' |label_size=86 |position=right |lat=52.591265 |long=-1.410327 |mark=Battle_icon_active_(crossed_swords).svg |marksize=18 |link=博斯沃思原野戰役}}
  {{Location map~ |England |label=[[布洛希思之役|布洛希思]] |label_size=86 |position=top |lat=52.913611 |long=-2.424722 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=布洛希思之役}}
  {{Location map~ |England |label=[[巴内特战役|巴内特]] |label_size=86 |position=top |lat=51.662233 |long=-0.200039 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=巴内特战役}}
  {{Location map~ |England |label={{link-en|斯托克場戰役|Battle of Stoke Field|東斯托克城}} |label_size=86 |position=top |lat=53.029058 |long=-0.892586 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=斯托克場戰役}}
  {{Location map~ |England |label=[[蒂克斯伯里戰役|蒂克斯伯里]] |label_size=86 |position=top |lat=51.986389 |long=-2.161389 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=蒂克斯伯里戰役}}
  {{Location map~ |England |label=貝里克 |label_size=86 |position=bottom |lat=55.771 |long=-2.007 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=倫敦 |label_size=86 |position=bottom |lat=51.507778 |long=-0.128056 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=約克 |label_size=86 |position=bottom |lat=53.958333 |long=-1.096667 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=普利茅斯 |label_size=86 |position=bottom |lat=50.371397 |long=-4.142431 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=普爾 |label_size=86 |position=bottom |lat=50.71942 |long=-1.98113 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=韋姆 |label_size=86 |position=left |lat=52.8555 |long=-2.7211 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=諾森伯蘭郡 |label_size=86 |position=right |lat=55.1 |long=-1.68 |mark=Steel pog.svg |marksize=1}}
  {{Location map~ |England |label=什魯斯伯里 |label_size=86 |position=bottom |lat=52.7077 |long=-2.7541 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |England |label=米爾福德港 |label_size=86 |position=bottom |lat=51.71418 |long=-5.04274 |mark=Steel pog.svg |marksize=6}}
}}
{{Tl2|Location map+}}用于在地图上放置一个或多个位置标记，并可选择添加标签。

Template:Location map+使用辅助模板{{Tl2|Location map~}}（一次或多次）为每个位置生成标记，所用的参数与[[Template:Location_map]]一样，包括经度、纬度、标示图像、标签文字、背景等。
{{clear}}

== 用法 ==
{| class="wikitable"
! rowspan=2 | 主模板（每个地图一个） !! colspan=3 | 辅助模板（每个标记位置一个）
|-
! colspan=3 | 多行样式
|- style="vertical-align:top"
| rowspan=4 | <syntaxhighlight lang="wikitext" style="width:14em; margin-right:2em;">
{{Location map+
| {{{1}}}
| width          =
| float          =
| border         =
| caption        =
| alt            =
| maplink        =
| relief         =
| AlternativeMap =
| overlay_image  =
| places         =
}}</syntaxhighlight>
|- style="vertical-align:top"
|<syntaxhighlight lang="wikitext" style="width:12em;">
{{Location map~
| {{{1}}}
| label       =
| label_size  =
| label_width =
| position    =
| background  =
| mark        =
| marksize    =
| link        =
| lat_deg     =
| lon_deg     =
}}</syntaxhighlight>
|<syntaxhighlight lang="wikitext" style="width:12em;">
{{Location map~
| {{{1}}}
| label       =
| label_size  =
| label_width =
| position    =
| background  =
| mark        =
| marksize    =
| link        =
| lat_deg     =
| lat_min     =
| lat_sec     =
| lat_dir     =
| lon_deg     =
| lon_min     =
| lon_sec     =
| lon_dir     =
}}</syntaxhighlight>
|<syntaxhighlight lang="wikitext" style="width:12em;">
{{Location map~
| {{{1}}}
| label       =
| label_size  =
| label_width =
| position    =
| background  =
| mark        =
| marksize    =
| link        =
| coordinates =
}}</syntaxhighlight>
|- style="vertical-align:top"
! colspan=3 | 单行样式
|- style="vertical-align:top"
| colspan=3 |<!--
--><syntaxhighlight lang="wikitext">{{Location map~ |{{{1}}} |label_size= |label_width= |background= |marksize= |mark= |lat_deg= |lon_deg= |position= |label= |link=}}</syntaxhighlight>
<!--
--><syntaxhighlight lang="wikitext">{{Location map~ |{{{1}}} |label_size= |label_width= |background= |marksize= |mark=  |lat_deg= |lat_min= |lat_sec= |lat_dir= |lon_deg= |lon_min= |lon_sec= |lon_dir= |position= |label= |link=}}</syntaxhighlight><!--
--><syntaxhighlight lang="wikitext">{{Location map~ |{{{1}}} |label_size= |label_width= |background= |marksize= |mark= |coordinates= |position= |label= |link=}}</syntaxhighlight>
'''注意'''：在单行样式中，参数顺序的排列是为了便于在后续{{T|Location map~}}调用中保持垂直对齐（从而提高wikicode可读性）。很少赋值的参数，或其值（通常）长度恒定或变化不大的参数放在前面；值长度经常差异较大的参数放在最后。参见下面的[[#single-line Location map~|示例]]（注意wikitext中{{para|marksize}}和{{para|position}}参数的对齐方式）。
|}

{{clear}}

== 参数 ==
{| class="wikitable" style="width:100%;"
|+ Location map+的参数
! 参数
! 说明
|-
| <code>{{{1}}}</code>
| 必填。将地图名称作为第一个未命名参数。例如，指定“China”将使用[[Module:Location map/data/China]]中为中国定义的值（如果存在），否则使用{{Tld|Location map China}}。参见下面的[[#示例|示例]]或[[Special:PrefixIndex/Module:Location_map/data/|所有子页面]]。
|-
| <code>width</code>
| 以[[像素]]为单位确定地图宽度，覆盖任何默认值。不要包含<code>px</code>：例如使用<code>width=300</code>，而不是<code>width=300px</code>。
|-
| <code>default_width</code>
| 以像素为单位确定地图的默认宽度，供模板（如信息框）使用。默认值为240。不要包含<code>px</code>。如果存在，此值将与单个地图模板中指定的<code>defaultscale</code>参数相乘，以便为垂直地图获得适当的大小。例如，如果给出<code>default_width=200</code>，泰国地图将以200×0.57=114像素的宽度显示（如[[Module:Location map/data/Thailand]]中所指定）。
|-
| <code>float</code>
| 指定地图在页面上的位置。有效值为<code>left</code>、<code>right</code>、<code>center</code>和<code>none</code>。默认为<code>right</code>。
|-
| <code>border</code>
| 指定1px地图边框的颜色。默认为“lightgrey”（参见[[网页颜色]]）。如果设置为<code>none</code>，则不生成边框。此参数很少使用。特殊值：{{code|infobox}}。
|-
| <code>caption</code>
| 显示在地图下方的标题文本。指定标题将使地图显示为带边框。如果定义了<code>caption</code>但未赋值，地图将不带边框且不显示标题。如果未定义<code>caption</code>，地图将不带边框并生成默认标题。默认标题由<code>label</code>参数（如果未定义则为当前页面名称）和地图定义模板中的<code>name</code>参数生成。参见下面的[[#示例|示例]]。
|-
| <code>alt</code>
| 地图的替代文本；供[[屏幕阅读器]]使用，参见[[WP:ALT]]。
|-
| <code>maplink</code>
| 指定点击地图时跟随的[[Wiki标记语言|维基链接]]，默认为地图源文件。可以通过<code>maplink =</code>停用，这在标记和标签有相关链接时避免误点击很有用。
|-
| <code>relief</code>
| 任何非空值（1、yes等）将使模板显示地图定义模板中指定为<code>image1</code>的地图，通常是[[地形图（计算机图形学）|地形图]]。其他数值如{{code|2}}或{{code|3}}将显示{{code|image2}}或{{code|image3}}（如果这些图像已定义）。
|-
| <code>AlternativeMap</code>
| 允许使用替代地图。图像必须与位置地图模板具有相同的边缘坐标。参见[[Template:Location map+/AlternativeMap|Location map+/AlternativeMap]]的示例。
|-
| <code>overlay_image</code>
| 允许在地图上叠加覆盖层。此参数很少使用。参见[[Template:Location map+/overlay|Location map+/overlay]]的示例。
|-
| <code>places</code>
| 使用{{Tl|Location map~}}指定一个或多个位置标记。
|}

{| class="wikitable" style="width:100%;"
|+ Location map~的参数
! 参数
! colspan="2" |说明
|-
| <code>{{{1}}}</code>
| colspan="2" |必填。将地图名称作为第一个未命名参数。例如，指定“China”将使用[[Module:Location map/data/China]]中为中国定义的值（如果存在），否则使用{{Tld|Location map China}}。参见下面的[[#示例|示例]]。
|-
| colspan="3" |'''标签'''
|-
| <code>label</code>
| colspan="2" |显示在标记旁边的标签文本。可以使用[[Wiki标记语言|维基链接]]。如果未指定，则默认为无标签，仅显示标记。{{red|不要使用{{Tag|div}}标签来尝试定位标签；请改用{{para|label_size}}和{{para|position}}。}}
|-
| <code>label_size</code>
| colspan="2" |标签的字体大小，以标签（已缩小的）正常字体大小的百分比表示（<100=更小，>100=更大）。默认为91；如果设置为更低的值，请遵守[[MOS:FONTSIZE]]。不要包含<code>%</code>：例如使用<code>label_size=95</code>，而不是<code>label_size=95%</code>。如果设置为0，标签仅在用户悬停在标记上时显示。
|-
| <code>label_width</code>
| colspan="2" |标签的宽度，以[[Em_(字体排印学)#CSS|em单位]]表示；默认宽度为6。不要包含{{kbd|em}}：例如使用{{para|label_width|7}}，而不是{{para|label_width|7em}}。
|-
| <code>position</code>
| colspan="2" |标签相对于标记的位置。有效值为<code>left</code>、<code>right</code>、<code>top</code>和<code>bottom</code>。默认为<code>right</code>。
|-
| <code>background</code>
| colspan="2" |标签的背景颜色。参见[[网页颜色]]。默认为无背景颜色，显示标签后的地图图像。
|-
| colspan="3" |'''标记'''
|-
| <code>mark</code>
| colspan="2" |用作标记的图像名称。默认为[[:File:Red pog.svg|Red pog.svg]]（[[File:Red pog.svg|8px]]）。更多标记图像可在[[Commons:Location markers]]和[[Commons:Category:Map icons]]找到。
|-
| <code>marksize</code>
| colspan="2" |标记的[[像素]]大小。默认为8。不要包含<code>px</code>：例如使用<code>marksize=10</code>，而不是<code>marksize=10px</code>。
|-
| <code>link</code>
| colspan="2" |指定读者点击标记时跟随的[[Wiki标记语言|维基链接]]。不要包含<code>[[]]</code>：例如使用<code>link=Yellowstone National Park</code>，而不是<code>link=[&#91;Yellowstone National Park&#93;]</code>。不要使用外部（https:）链接。
|-
| colspan="3" |'''坐标'''
|-
|<code>lat_deg</code>
| rowspan="2" |常用
|必填。[[纬度]]的度数，使用[[十进制度]]。逻辑上，南纬使用负数。
|-
|<code>lon_deg</code>
|必填。[[经度]]的度数，使用十进制度。逻辑上，西经使用负数。
|-
|<code>lat_deg</code>
| rowspan="8" |详细
| 必填。[[纬度]]的度数。必须指定分钟，可能还需要指定秒。<ref group="注" name="precision" />
|-
| <code>lat_min</code>
| 纬度的分钟。<ref group=注 name="precision" />符号应与lat_deg一致。
|-
| <code>lat_sec</code>
| 纬度的秒。通常不需要。<ref group=注 name="precision" />符号应与lat_deg一致。
|-
| <code>lat_dir</code>
| 北纬为N（默认值），南纬为S。其他值将被忽略。
|-
| <code>lon_deg</code>
| 必填。[[经度]]的度数。必须指定分钟，可能还需要指定秒。<ref group=注 name="precision" />
|-
| <code>lon_min</code>
| 经度的分钟。<ref group=注 name="precision" />符号应与lon_deg一致。
|-
| <code>lon_sec</code>
| 经度的秒。通常不需要。<ref group=注 name="precision" />符号应与lon_deg一致。
|-
| <code>lon_dir</code>
| 东经为E（默认值），西经为W。其他值将被忽略。
|-
| <code>coordinates</code>
|替代
|使用{{Tl|Coord}}模板的坐标，例如<code><nowiki>{{coord|48.067|-2.863}}</nowiki></code>。
|}

注：
{{Reflist
| group = 注
| refs =
<ref group=注 name="precision">应使用适当的精度。例如，整个美国地图，宽度为1000{{nbhyph}}像素时，分辨率约为5公里/像素。在十进制度格式中只需2位小数精度（≈1公里），或在DMS格式中只需整分钟（≈1.7公里）。</ref>
}}

== 可用地图 ==

可通过以下来源查找位置地图：

:[[Special:PrefixIndex/Module:Location map/data/]] - 在搜索地图模板之前检查。新地图应在此创建，而不是创建新模板。
:[[Special:WhatLinksHere/Template:Location map/Info]] - 可能有用的搜索。
:[[Special:Prefixindex/Template:Location map]] - 另一个可能有用的搜索。

== 示例 ==

此示例未指定<code>caption</code>参数。它演示了默认值的使用。请注意，默认标题是页面名称后跟括号中的地图名称，并且如果标签太靠近边缘，其位置会自动调整。
{{Location map+ | Australia
| places =
  {{Location map~ | Australia
    | label = Sydney
    | lat_deg = -33.86
    | lon_deg = 151.21 }}
  {{Location map~ | Australia
    | label = Melbourne
    | coordinates = {{coord|-37.81|144.96}}
  }}
}}
<syntaxhighlight lang="wikitext" style="width:35em;">
{{Location map+ | Australia
| places =
  {{Location map~ | Australia
    | label = Sydney
    | lat_deg = -33.86
    | lon_deg = 151.21 }}
  {{Location map~ | Australia
    | label = Melbourne
    | coordinates = {{coord|-37.81|144.96}}
  }}
}}
}}</syntaxhighlight>

{{clear}}
{{anchor|single-line Location map~}}此示例使用了指定但为空的<code>caption</code>。它演示了使用[[十进制度]]的坐标、带链接的10px标记，以及以单行样式列出的{{Tl|Location map~}}条目。
{{Location map+ | France
| caption =
| places =
  {{Location map~ |France |marksize=10 |lat_deg=48.8567 |lon_deg=2.3508 |position=top    |label=Paris     |link=Paris    }}
  {{Location map~ |France |marksize= 9 |lat_deg=43.2964 |lon_deg=5.3610 |position=bottom |label=Marseille |link=Marseille}}
}}
<syntaxhighlight lang="wikitext" style="width:75em;">
{{Location map+ | France
| caption =
| places =
  {{Location map~ |France |marksize=10 |lat_deg=48.8567 |lon_deg=2.3508 |position=top    |label=Paris     |link=Paris    }}
  {{Location map~ |France |marksize= 9 |lat_deg=43.2964 |lon_deg=5.3610 |position=bottom |label=Marseille |link=Marseille}}
}}
</syntaxhighlight>
{{clear}}

此示例使用了带赋值的<code>caption</code>。它演示了度分秒格式的坐标、地形图、标签背景色和带链接的标签。
{{Location map+ | USA
| width = 300
| caption = Some cites in the United States
| relief = 1
| places =
  {{Location map~ | USA
    | label = [[New York City|New York]]
    | position =
    | background = white
    | mark = Cyan pog.svg
    | alt = alt text for New York City
    | link = New York City
    | lat_deg = 40 | lat_min = 43 | lat_dir = N
    | lon_deg = 74 | lon_min = 0  | lon_dir = W
  }}
  {{Location map~| USA
    | label = [[San Francisco]]
    | position =
    | background = white
    | mark = Purple pog.svg
    | alt = alt text for San Francisco
    | link = San Francisco
    | lat_deg = 37  | lat_min = 46 | lat_dir = N
    | lon_deg = 122 | lon_min = 25 | lon_dir = W
  }}
}}
<syntaxhighlight lang="wikitext" style="width:35em;">
{{Location map+ | USA
| width = 300
| caption = Some cites in the United States
| relief = 1
| places =
  {{Location map~ | USA
    | label = [[New York City|New York]]
    | position =
    | background = white
    | mark = Cyan pog.svg
    | alt = alt text for New York City
    | link = New York City
    | lat_deg = 40 | lat_min = 43 | lat_dir = N
    | lon_deg = 74 | lon_min = 0  | lon_dir = W
  }}
  {{Location map~| USA
    | label = [[San Francisco]]
    | position =
    | background = white
    | mark = Purple pog.svg
    | alt = alt text for San Francisco
    | link = San Francisco
    | lat_deg = 37  | lat_min = 46 | lat_dir = N
    | lon_deg = 122 | lon_min = 25 | lon_dir = W
  }}
}}
</syntaxhighlight>

另请参见{{Tl|Location map}}和{{Tl|Location map many}}的示例，以及：
* [[Template:Location map+/AlternativeMap]] - 使用“AlternativeMap”参数的示例
* [[Template:Location map+/overlay]] - 使用“overlay_image”参数的示例

== 参见 ==
* [[:en:Wikipedia:Maps for Wikipedia]] - 维基百科上可用的地图工具列表
* {{Tl|Location map}} - 用于通过经纬度显示单个标记。
* {{Tl|Location map many}} - 用于通过经纬度显示多个标记。
* [[:Commons:Category:Map pointers]] - 维基共享资源上众多指针符号的列表。
* {{Tl|OSM Location map}} - 带有"交互式全屏"版本的OpenStreetMap地图。允许使用标签、编号点、标题、说明文字、迷你定位地图和覆盖层。
* {{Tl|Overlay}} - 允许在图像上叠加编号、文字编号或彩色标签，以指示图像中的特定特征。
* {{Tl|CSS crop}} - 允许裁剪地图的包装模板。

<includeonly>{{Sandbox other||<!-- 本行下加入模板的分類 -->
[[Category:地理位置圖模板| ]]
}}</includeonly>