imported>Kcx36 来自 2025年11月28日 (五) 10:04

2025-11-28T10:04:00Z

新页面

{{NoteTA
|G1=MediaWiki
|G2=IT
|1=zh-hans:地理要素;zh-hant:地理資料;
}}
{{Documentation subpage}}
{{High-use}}
{{lua|Module:Infobox mapframe}}
{{Uses Wikidata|P625}}
{{Tracks Wikidata|P402}}
{{Sister project
|image=[[File:Openstreetmap logo.svg|40x40px]]
|text=This template uses the [[OpenStreetMap]] tag:
*'''''[http://wiki.openstreetmap.org/wiki/Key:wikidata wikidata]''''' (see [http://wiki.openstreetmap.org/wiki/Talk:Key:wikidata talk]; [https://taginfo.openstreetmap.org/keys/wikidata taginfo])
}}

== 概要 ==
本模板會生成地圖框架，以最精簡的方式套用進各式各樣的資訊框（Infobox）模板。模板僅適用於單一地理要素（點、線、面）。如果想要同時顯示多個地理資料或是更多進階資訊，請改用{{tlx|maplink}}模板。

'''請注意'''：如果未提供坐标，将从页面的维基数据项中获取坐标。在这种情况下，如果未设置{{para|point}}，则除非有指定{{Q|P402}}，否則預設以點狀顯示座標。
*沒有{{Q|P402}}的頁面參見[[:Category:Infobox mapframe在維基數據上沒有OSM關係標識符]]。
*本模板不要直接用到正文中。

常见问题及解答见[[#常见问题及解答|下方]]。

== 使用方法 ==
'''注意：'''當在主命名空间使用時，不需要設定{{para|id}}參數（除非是要加入其他頁面資訊）。

如果需要某信息框自动显示地图，可使用<code><nowiki>{{#invoke:Infobox mapframe|auto}}</nowiki></code>，详见[[Module:Infobox mapframe/doc]]。

===基本===
<syntaxhighlight lang="wikitext">{{Infobox mapframe}}</syntaxhighlight>
在不带参数或仅使用{{para|id}}时，地图将显示点、线或面特征，具体取决于维基数据和OpenStreetMap上的可用数据。
*如果维基数据项未指定{{Q|P402}}值，则除了OSM线或面特征之外，还将默认显示点标记。
*如果维基数据项未指定{{Q|P625}}或{{Q|P3896}}值，则不会显示地图。
{{cot|基本用法示例}}
点标记（维基数据坐标）：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q7270550}}</syntaxhighlight>
{{Infobox mapframe |id=Q7270550}}
线特征：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q1318331}}</syntaxhighlight>
{{Infobox mapframe |id=Q1318331}}
面特征：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q61}}</syntaxhighlight>
{{Infobox mapframe |id=Q61}}
{{cob}}

===使用指定的坐标，而不是维基数据坐标===
仅点标记，无线/面特征：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |coord=}}</syntaxhighlight>
点标记和线/面特征（如有）：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |wikidata=yes |coord=}}</syntaxhighlight>

使用{{tlx|Coord}}模板指定坐标，例如{{para|坐标|2={{tlx|坐标|32.1|S|116.2|E}}}}
*如果指定了{{para|coord}}，则默认情况下仅显示该坐标的点标记（不显示线/面特征）
*如果指定了{{para|coord}}并使用{{para|wikidata|yes}}，那么将显示该坐标的点标记，以及链接到维基数据项目的线/面特征。
{{cot|指定坐标示例}}
点标记（显示指定坐标，不显示维基数据项的线/面特征）：
<syntaxhighlight lang="wikitext">{{infobox mapframe |coord={{coord|31|56|S|115|58|E}} }}</syntaxhighlight>
{{infobox mapframe |id=Q45935 |coord={{coord|31|56|S|115|58|E}} }}
点标记（显示指定坐标，以及维基数据项的线/面特征）：
<syntaxhighlight lang="wikitext">{{infobox mapframe |wikidata=yes |coord={{coord|31|56|S|115|58|E}} }}</syntaxhighlight>
{{infobox mapframe |id=Q45935 |wikidata=yes |coord={{coord|31|56|S|115|58|E}} }}
{{cob}}

===自定义显示哪些特征===
====反转面====
<syntaxhighlight lang="wikitext">{{Infobox mapframe |shape=inverse}}</syntaxhighlight>
Replace the shape with an inverse-shape (geomask) by setting {{para|shape|inverse}}
{{cot|Inverse shape example}}
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q61 |shape=inverse}}</syntaxhighlight>
{{Infobox mapframe |id=Q61 |shape=inverse}}
{{cob}}

====打开或关闭点标记====
强制显示点标记：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |point=on}}</syntaxhighlight>
阻止显示点标记：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |point=none}}</syntaxhighlight>

====关闭线特征====
阻止显示线特征：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |line=none}}</syntaxhighlight>

====关闭面特征====
阻止显示面特征：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |shape=none}}</syntaxhighlight>

===显示相关维基数据项目中的遮罩===
<syntaxhighlight lang="wikitext">{{Infobox mapframe |geomask=}}</syntaxhighlight>
将{{para|geomask}}设置为维基数据项QID或属性id，例如{{Q|P17}}。
{{cot|Geomask examples}}
使用链接到{{q|P17}}声明的项作为遮罩：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q3239281 |geomask=P17}}</syntaxhighlight>
{{Infobox mapframe |id=Q3239281 |geomask=P17}}
使用项目{{q|Q1199}}作为遮罩：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q3239281 |geomask=Q1199}}</syntaxhighlight>
{{Infobox mapframe |id=Q3239281 |geomask=Q1199}}
{{cob}}

===根据对象长度或面积确定缩放===
使用{{para|length_km}}或{{para|length_mi}}或{{para|area_km2}}或{{para|area_mi2}}
{{cot|根据长度/面积缩放的示例}}
根据对象长度（以公里或英里为单位）确定缩放：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q1318331 |length_km=5.6}}</syntaxhighlight>
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q1318331 |length_mi=3.5}}</syntaxhighlight>
{{Infobox mapframe |id=Q1318331 |length_km=5.6}}
根据对象面积（以平方公里或平方英里为单位）确定缩放：
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q100 |area_km2=232.14}}</syntaxhighlight>
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q100 |area_mi2=89.63}}</syntaxhighlight>
{{Infobox mapframe |id=Q100 |area_km2=232.14}}
{{cob}}

===如果在维基数据上沒有坐标===
<syntaxhighlight lang="wikitext">{{Infobox mapframe |id=Q1}}</syntaxhighlight>
{{Infobox mapframe |id=Q1 }}
不會顯示任何東西。或是該頁面在Wikidata上亦沒有任何項目（例如：[[Template:Infobox_mapframe/doc|這個模板文件檔頁面]]）
<syntaxhighlight lang="wikitext">{{Infobox mapframe}}</syntaxhighlight>
{{Infobox mapframe}}
這也不會顯示任何東西。

更多示例见[[Template:Infobox_mapframe/testcases|测试样例]]。

==参数==
所有参数均为可选参数。
{{Infobox mapframe/doc/parameters|noprefix=yes|deprecated=yes}}

== 模板数据 ==
{{collapse top|title=模板数据}}
{{TemplateData header}}
<templatedata>
{
"params": {
"mapframe": {
"label": "显示地图框架",
"description": "指定“yes”或“no”以显示或隐藏地图，这将覆盖默认设置。",
"example": "yes",
"type": "string",
"default": "no",
"suggested": true
},
"mapframe-caption": {
"label": "地图框架说明",
"description": "地图框架的说明文字。如果设置了mapframe-geomask，则默认为“在<<geomask标签>>的位置”。",
"type": "string"
},
"mapframe-custom": {
"label": "自定义地图框架",
"description": "使用自定义地图代替自动地图框架。请使用{{maplink}}模板（或其他可生成地图框架的模板）或图像文件名称。如果使用，后续的mapframe参数将被忽略。",
"type": "wiki-template-name"
},
"mapframe-id": {
"aliases": [
"id",
"qid"
],
"label": "地图框架维基数据项",
"description": "要使用的维基数据项QID。",
"type": "string",
"default": "（当前页面的项目）"
},
"mapframe-coordinates": {
"aliases": [
"mapframe-coord",
"coordinates",
"coord"
],
"label": "地图框架坐标",
"description": "如果不使用维基数据上的坐标，则指定要使用的坐标。请使用{{Coord}}模板。",
"example": "{{Coord|12.34|N|56.78|E}}",
"type": "wiki-template-name",
"default": "（维基数据上的坐标）"
},
"mapframe-wikidata": {
"label": "地图框架显示线/面",
"description": "当坐标通过参数指定时，设置为“yes”以显示维基数据项中的面/线要素（如果有的话）。",
"type": "string",
"suggestedvalues": [
"yes"
]
},
"mapframe-point": {
"label": "地图框架点标记",
"description": "覆盖地图框架点标记的显示。设置为“none”以关闭点要素的显示。设置为“on”以强制显示点标记。",
"type": "string",
"suggestedvalues": [
"none",
"on"
]
},
"mapframe-line": {
"label": "地图框架线特征",
"description": "覆盖地图框架线特征的显示。设为“none”时关闭线特征的显示。",
"type": "string",
"suggestedvalues": [
"none"
]
},
"mapframe-shape": {
"label": "地图框架面特征",
"description": "覆盖地图框架面特征的显示。设置为“none”以关闭显示。设置为“inverse”以使用反转形状（geomask）代替常规形状。",
"type": "string",
"suggestedvalues": [
"none"
]
},
"mapframe-geomask": {
"label": "地图框架遮罩",
"description": "用作遮罩的维基数据项（遮罩边界外的区域变暗）。可以是特定的维基数据项（QID），或数据项的属性（例如，P17表示国家 (P17)，P131表示所在行政领土实体 (P131)）。",
"example": "Q100",
"type": "wiki-page-name"
},
"mapframe-frame-width": {
"aliases": [
"mapframe-width"
],
"label": "地图框架宽度",
"description": "地图框架宽度，以像素为单位。",
"type": "number",
"default": "270"
},
"mapframe-frame-height": {
"aliases": [
"mapframe-height"
],
"label": "地图框架高度",
"description": "地图框架高度，以像素为单位。",
"type": "number",
"default": "200"
},
"mapframe-shape-fill": {
"label": "地图框架面填充颜色",
"description": "面特征的填充颜色。",
"type": "string",
"default": "#606060"
},
"mapframe-shape-fill-opacity": {
"label": "地图框架面填充不透明度",
"description": "面特征填充的不透明度，数值介于0和1之间。",
"type": "number",
"default": "0.5"
},
"mapframe-stroke-color": {
"aliases": [
"mapframe-stroke-colour"
],
"label": "地图框架线颜色",
"description": "线特征、面特征轮廓的颜色。",
"type": "string",
"default": "#ff0000"
},
"mapframe-stroke-width": {
"label": "地图框架线粗细",
"description": "线特征、面特征轮廓的粗细。",
"type": "number",
"default": "5"
},
"mapframe-marker": {
"label": "地图框架标记符号",
"description": "用于坐标点标记的符号；具体选项参见[[mw:Help:Extension:Kartographer/Icons]]。",
"example": "museum",
"type": "string"
},
"mapframe-marker-color": {
"aliases": [
"mapframe-marker-colour"
],
"label": "地图框架标记颜色",
"description": "点标记的背景颜色。",
"type": "string",
"default": "#5E74F3"
},
"mapframe-geomask-stroke-color": {
"aliases": [
"mapframe-geomask-stroke-colour"
],
"label": "地图框架遮罩轮廓颜色",
"description": "遮罩轮廓的颜色。",
"type": "string",
"default": "#555555"
},
"mapframe-geomask-stroke-width": {
"label": "地图框架遮罩轮廓粗细",
"description": "遮罩轮廓的粗细。",
"type": "number",
"default": "2"
},
"mapframe-geomask-fill": {
"label": "地图框架遮罩填充颜色",
"description": "遮罩外部区域的填充颜色。",
"type": "string",
"default": "#606060"
},
"mapframe-geomask-fill-opacity": {
"label": "地图框架遮罩填充不透明度",
"description": "遮罩外部区域填充的不透明度，数值介于0和1之间。",
"type": "number",
"default": "0.5"
},
"mapframe-zoom": {
"label": "地图框架缩放级别",
"description": "设置缩放级别，从“1”（全球地图）到 “18”（最大级别），用于无法根据对象长度或面积自动确定缩放级别的情况。",
"example": "12",
"type": "number",
"default": "10"
},
"mapframe-length_km": {
"label": "地图框架对象长度（公里）",
"description": "以公里为单位的对象长度，用于自动确定缩放级别。请仅填写长度或面积其中之一。 ",
"type": "number"
},
"mapframe-length_mi": {
"label": "地图框架对象长度（英里）",
"description": "以英里为单位的对象长度，用于自动确定缩放级别。请仅填写长度或面积其中之一。 ",
"type": "number"
},
"mapframe-area_km2": {
"label": "地图框架对象面积（平方公里）",
"description": "以平方公里为单位的对象面积，用于自动确定缩放级别。请仅填写长度或面积其中之一。 ",
"type": "number"
},
"mapframe-area_mi2": {
"label": "地图框架对象面积（平方英里）",
"description": "以平方英里为单位的对象面积，用于自动确定缩放级别。请仅填写长度或面积其中之一。 ",
"type": "number"
},
"mapframe-frame-coordinates": {
"aliases": [
"mapframe-frame-coord"
],
"label": "地图框架初始位置坐标",
"description": "地图初始位置的备用坐标，使用{{coord}}模板。",
"example": "{{Coord|12.35|N|56.71|E}}",
"type": "wiki-template-name"
},
"mapframe-switcher": {
"label": "地图框架切换",
"description": "设置为“auto”、“geomasks”或“zooms”，以启用切换多个地图框架的功能（以Template:Switcher的风格）。设置为auto — 以维基数据项的位置（P276）和所在行政领土实体（P131）陈述为遮罩进行切换，递归搜索。例如，数据项的城市、该城市的州以及该州的国家。设置为geomasks — 在mapframe-geomask参数中指定的、以逗号分隔的维基数据项（QID）列表指定的遮罩之间切换。设置为zooms — 在“放大”/“中等缩放”/“缩小”之间切换，其中“放大”为默认缩放（最小为3），“缩小”为1，“中等缩放”为平均值。",
"type": "string",
"suggestedvalues": [
"auto",
"geomasks",
"zooms"
]
}
}
}
</templatedata>
{{collapse bottom}}

==常见问题及解答==
{{Maplink/doc/FAQ}}

<includeonly>{{sandbox other||


}}</includeonly>

Template:Infobox mapframe/doc - 版本历史

imported>Kcx36 来自 2025年11月28日 (五) 10:04