模板:Infobox mapframe

模板文档[查看] [编辑] [历史] [清除缓存]

概要

本模板会生成地图框架，以最精简的方式套用进各式各样的资讯框（Infobox）模板。模板仅适用于单一地理要素（点、线、面）。如果想要同时显示多个地理资料或是更多进阶资讯，请改用{{maplink}}模板。

请注意：如果未提供坐标，将从页面的维基数据项中获取坐标。在这种情况下，如果未设置|point=，则除非有指定OSM关系标识符 (P402)，否则预设以点状显示座标。

• 没有OSM关系标识符 (P402)的页面参见Category:Infobox mapframe在维基数据上没有OSM关系标识符。
• 本模板不要直接用到正文中。

常见问题及解答见下方。

使用方法

注意：当在主命名空间使用时，不需要设定|id=参数（除非是要加入其他页面资讯）。

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

基本

{{Infobox mapframe}}

在不带参数或仅使用|id=时，地图将显示点、线或面特征，具体取决于维基数据和OpenStreetMap上的可用数据。

• 如果维基数据项未指定OSM关系标识符 (P402)值，则除了OSM线或面特征之外，还将默认显示点标记。
• 如果维基数据项未指定地理坐标 (P625)或地理形状 (P3896)值，则不会显示地图。

基本用法示例

点标记（维基数据坐标）：

{{Infobox mapframe |id=Q7270550}}

线特征：

{{Infobox mapframe |id=Q1318331}}

面特征：

{{Infobox mapframe |id=Q61}}

使用指定的坐标，而不是维基数据坐标

仅点标记，无线/面特征：

{{Infobox mapframe |coord=}}

点标记和线/面特征（如有）：

{{Infobox mapframe |wikidata=yes |coord=}}

使用{{Coord}}模板指定坐标，例如|坐标={{坐标|32.1|S|116.2|E}}

• 如果指定了|coord=，则默认情况下仅显示该坐标的点标记（不显示线/面特征）
• 如果指定了|coord=并使用|wikidata=yes，那么将显示该坐标的点标记，以及链接到维基数据项目的线/面特征。

指定坐标示例

点标记（显示指定坐标，不显示维基数据项的线/面特征）：

{{infobox mapframe |coord={{coord|31|56|S|115|58|E}} }}

点标记（显示指定坐标，以及维基数据项的线/面特征）：

{{infobox mapframe |wikidata=yes |coord={{coord|31|56|S|115|58|E}} }}

自定义显示哪些特征

反转面

{{Infobox mapframe |shape=inverse}}

Replace the shape with an inverse-shape (geomask) by setting |shape=inverse

Inverse shape example

{{Infobox mapframe |id=Q61 |shape=inverse}}

打开或关闭点标记

强制显示点标记：

{{Infobox mapframe |point=on}}

阻止显示点标记：

{{Infobox mapframe |point=none}}

关闭线特征

阻止显示线特征：

{{Infobox mapframe |line=none}}

关闭面特征

阻止显示面特征：

{{Infobox mapframe |shape=none}}

显示相关维基数据项目中的遮罩

{{Infobox mapframe |geomask=}}

将|geomask=设置为维基数据项QID或属性id，例如国家 (P17)。

Geomask examples

使用链接到国家 (P17)声明的项作为遮罩：

{{Infobox mapframe |id=Q3239281 |geomask=P17}}

使用项目黑森州 (Q1199)作为遮罩：

{{Infobox mapframe |id=Q3239281 |geomask=Q1199}}

根据对象长度或面积确定缩放

使用|length_km=或|length_mi=或|area_km2=或|area_mi2=

根据长度/面积缩放的示例

根据对象长度（以公里或英里为单位）确定缩放：

{{Infobox mapframe |id=Q1318331 |length_km=5.6}}

{{Infobox mapframe |id=Q1318331 |length_mi=3.5}}

根据对象面积（以平方公里或平方英里为单位）确定缩放：

{{Infobox mapframe |id=Q100 |area_km2=232.14}}

{{Infobox mapframe |id=Q100 |area_mi2=89.63}}

如果在维基数据上没有坐标

{{Infobox mapframe |id=Q1}}

不会显示任何东西。或是该页面在Wikidata上亦没有任何项目（例如：这个模板文件档页面）

{{Infobox mapframe}}

这也不会显示任何东西。

更多示例见测试样例。

参数

所有参数均为可选参数。

• 基本参数：
  • id — 要使用的维基数据项QID。默认：当前页面对应数据项
  • coordinates或coord — 指定的坐标，而不是维基数据上的坐标。使用{{Coord}}模板，例如：|coord={{Coord|12.34|N|56.78}}。默认：来自维基数据的坐标
  • wikidata — 当设置了|coord=时，设为yes以显示维基数据中的面/线特征（如果有）。默认： 未指定
• 自定义显示哪些特征：
  • point — 设为none时关闭点标记的显示。设为on时强制显示点标记。默认： 未指定
  • line — 设为none时关闭线特征的显示。默认： 未指定
  • shape — 设为none时关闭面特征的显示。设为inverse时使用反转形状（geomask）代替常规形状。默认： 未指定
  • geomask — 用作遮罩的维基数据项（遮罩边界外的区域变暗）。可以是特定的维基数据项（QID），或数据项的属性（例如，P17表示国家 (P17)，P131表示所在行政领土实体 (P131)）。默认： 未指定
  • switcher — 设置为auto或geomasks或zooms，以启用切换多个地图框架的功能（以Template:Switcher的风格）。默认： 未指定
    • auto — 以维基数据项的位置 (P276)和所在行政领土实体 (P131)声称为遮罩进行切换，递归搜索。例如，数据项的城市、该城市的州以及该州的国家。
    • geomasks — 在geomask参数中的维基数据项（QID）列表（以逗号分隔）指定的遮罩之间切换。
    • zooms — 在“zoomed in”/“zoomed midway”/“zoomed out”之间切换，其中“zoomed in”为默认缩放（最小值为3），“zoomed out”为1，而“zoomed midway”为平均值。
• 其他可选参数：
  • frame-width或width — 框架宽度。默认：270
  • frame-height或height — 框架高度。默认：200
  • shape-fill — 面特征的填充颜色。默认：#606060
  • shape-fill-opacity — 面特征填充的不透明度，数值介于0和1之间。默认：0.5
  • stroke-color或stroke-colour — 线特征、面特征轮廓的颜色。默认：#ff0000
  • stroke-width — 线特征、面特征轮廓的粗细。默认：5
  • marker — 用于坐标点标记的符号；具体选项参见mw:Help:Extension:Kartographer/Icons。默认： 未指定（即blank）
    • 也可以设置为blank以覆盖默认标记符号。
  • marker-color或marker-colour — 点标记的背景颜色。默认：#5E74F3
  • geomask-stroke-color或geomask-stroke-colour — 遮罩轮廓的颜色。默认：#555555
  • geomask-stroke-width — 遮罩轮廓的粗细。默认：2
  • geomask-fill — 遮罩外部区域的填充颜色。默认：#606060
  • geomask-fill-opacity — 遮罩外部区域填充的不透明度，数值介于0和1之间。默认：0.5
  • zoom — 设置缩放级别，从“1”（全球地图）到 “18”（最大级别），用于无法根据对象长度或面积自动确定缩放级别的情况。默认：10
  • length_km或length_mi或area_km2或area_mi2 — 通过输入对象的长度（以公里或英里为单位）或面积（以平方公里或平方英里为单位）来确定缩放级别。默认：未指定
  • frame-coordinates或frame-coord — 地图初始位置的备用坐标，使用使用{{coord}}模板。默认：衍生自项目坐标
• 弃用参数：
  • frame-lat或frame-latitude — 地图初始位置的备用纬度；默认衍生自项目坐标。
  • frame-long或frame-longitude — 地图初始位置的备用经度；默认衍生自项目坐标。

模板数据

模板数据

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

Infobox mapframe模板数据

无描述。

模板参数[编辑模板数据]

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

常见问题及解答

Q1：为什么来自OpenStreetMap的线状或面状要素没有显示？

A1：有几种可能的原因：

• 根据mw:Help:Extension:Kartographer/OSM，OSM上的要素需要标记维基数据ID。仅在维基数据项上设置OSM关系标识符 (P402)是不够的。
• 只能使用某些OSM关系（类型为multipolygon、route、waterway和boundary的关系），而不能使用其他类型如建筑物和公共交通主干路线。请参阅mw:Help:Extension:Kartographer/OSM#Limitation和phab:T156433。
• 在OSM上标记后，可能需要1到2天数据才能在此处可用。
• 维基媒体偶尔在复制OSM数据时出现问题（例如phab:T218097），或因其他问题有意禁用复制（例如phab:T243609）

Q2：当底图出现问题时在哪里提交错误报告？（例如缺失湖泊）

A2：如果该问题也出现在OpenStreetMap上，则需要在OpenStreetMap上修复。如果问题仅出现在维基媒体地图上，可以在Phabricator上报告（您可以使用维基百科账户登录）。请参阅mw:How to report a bug获取操作说明（对于标签，请使用Maps）。（或者，您可以尝试mw:Help talk:Extension:Kartographer）

Q3：在哪里报告地图的其他错误或问题？

A3：这可能是维基百科模块的问题，也可能是底层软件的错误（这类错误很多）。

• 如果使用纯<mapframe>...</mapframe>标签时也出现该问题，则应在Phabricator上报告（您可以使用维基百科账户登录）。请参阅mw:How to report a bug获取操作说明（对于标签，请使用Maps）。（或者，您可以尝试mw:Help talk:Extension:Kartographer）
• 如果问题仅出现在维基百科的模板/模块中，或者您不确定，请在Wikipedia:互助客栈/技术报告。

Q4：为什么查看页面时缩略图地图呈现为静态图像，而编辑页面时却是交互式的？

A4：在维基百科以及除维基导游外的大多数wiki上，嵌入的缩略图是静态地图，需要打开全屏地图后才能进行缩放或平移。这是出于性能考虑，以便在禁用JavaScript时能显示某些内容，并方便打印。
预览模式显示交互式地图是一个错误，phab:T203863（也是一个性能问题）。更多解释可以在phab:T202793的评论中找到。

Q5：为什么编辑或添加地图后，线状、面状或点状要素没有显示，尽管它们在页面预览中显示过？

A5：这是一个与生成缩略图图像相关的错误。它应该在一两个小时内自行修复。详情请参阅phab:T269984。

Q6：使用mapframe的|raw=参数（在使用Module:Infobox mapframe的信息框的|mapframe-custom=参数内）的页面显示“运行脚本的分配时间已到”的错误消息。该怎么办？

A6：如果要处理的原始数据量过大，可能会显示该超时消息。您可以尝试将原始数据移至Commons（示例）或使用Special:ExpandTemplates将mapframe模板替换为等效的wikitext（示例）

上述文档嵌入自Template:Infobox mapframe/doc。 (编辑 | 历史)
编者可以在本模板的沙盒 (编辑 | 差异)和测试样例 (编辑)页面进行实验。
请在/doc子页面中添加分类。 本模板的子页面。