模板:Infobox mapframe

File:Test Template Info-Icon - Version (2).svg 模板文档[查看] [编辑] [历史] [清除缓存]

概要

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

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

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

常见问题及解答见下方。

使用方法

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

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

基本

{{Infobox mapframe}}

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

• 如果维基数据项未指定 (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模板数据

<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 text="Map">[

]</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": "如果不使用维基数据上的坐标，则指定要使用的坐标。请使用模板。", "example": "", "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": "地图初始位置的备用坐标，使用模板。", "example": "", "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>

常见问题及解答

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

A1：有几种可能的原因：

• 根据mw:Help:Extension:Kartographer/OSM，OSM上的要素需要标记维基数据ID。仅在维基数据项上设置 (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子页面中添加分类。本模板的子页面。