模組:Infobox mapframe/doc

该模块用于在信息框中自动生成mapframe交互式地图，编者只需输入少量参数即可实现。

通用用法

直接使用模板{{Infobox mapframe}}，参照其文档说明即可。本模块也可导入其他Lua模块使用。

在信息框模板中嵌入

示例编辑: Template:Infobox prison、Template:Infobox prison/doc

修改模板

若要将mapframe地图集成到现有的信息框模板中，需在模板代码的适当位置添加调用语句。地图可以放置在信息框的顶部附近（通常在图片下方）或底部，参照以下示例修改模板即可（注意根据现有图片或data参数的数量调整数字编号，如下方的4，或97、99）：

若置于信息框顶部附近	若置于信息框底部附近
| image4 = {{#invoke:Infobox mapframe|auto}} | caption4 = {{#invoke:Infobox mapframe|autocaption}}	| header97 = {{#if:{{{mapframe|}}}|地图}} | data98 = {{#invoke:Infobox mapframe|auto}} | data99 = {{#invoke:Infobox mapframe|autocaption}}

完成上述修改后，该信息框模板即可支持Infobox mapframe的所有参数。

• 如果模板中调用了{{#invoke:Check for unknown parameters|check}}，只需在调用中添加|mapframe_args=y，即可将所有mapframe相关参数识别为已知参数。
• 默认情况下，地图功能是关闭的，即只有在条目调用信息框时传入|mapframe=yes参数才会显示地图。若希望默认开启地图，可以在#invoke调用中添加|onByDefault=yes，此时地图默认显示，除非条目调用时传入|mapframe=no。
  • onByDefault也支持条件表达式，例如|onByDefault={{#if:{{{pushpin_map|}}}|no|yes}}，表示如果条目中使用了{{{pushpin_map|}}}参数，则关闭地图功能，否则默认开启。
• 在#invoke调用中可以指定参数的默认值。例如，若希望默认使用图书馆图标作为标记，则写为：{{#invoke:Infobox mapframe|auto|mapframe-marker=library}}，这样除非在具体条目调用时指定了其他值，否则均使用该默认图标。

更新模板文档

在信息框模板的文档中，如需说明Infobox mapframe相关参数，可以使用{{Infobox mapframe/doc/parameters}}模板。该模板支持通过|参数名=值的形式指定默认值（如果在#invoke调用中指定了默认值）。以下是默认输出：

延伸內容

• 基本参数：
  • mapframe — 指定yes或no以显示或隐藏地图，覆盖默认值。默认：no
  • mapframe-caption — 地图说明。默认： 空白（或如果设置了|mapframe-geomask=，则：“在<遮罩标签>的位置”）
  • mapframe-custom — 使用自定义地图代替自动地图框架。请使用{{maplink}}模板（或其他可生成地图框架的模板）或图像文件名称。如果使用，后续的mapframe参数将被忽略。默认：未指定
  • mapframe-id或id或qid — 要使用的维基数据项QID。默认：当前页面对应数据项
  • mapframe-coordinates或mapframe-coord或coordinates或coord — 指定的坐标，而不是维基数据上的坐标。使用{{Coord}}模板，例如：|coord={{Coord|12.34|N|56.78}}。默认：来自维基数据的坐标
  • mapframe-wikidata — 当设置了|coord=时，设为yes以显示维基数据中的面/线特征（如果有）。默认： 未指定
• 自定义显示哪些特征：
  • mapframe-point — 设为none时关闭点标记的显示。设为on时强制显示点标记。默认： 未指定
  • mapframe-line — 设为none时关闭线特征的显示。默认： 未指定
  • mapframe-shape — 设为none时关闭面特征的显示。设为inverse时使用反转形状（geomask）代替常规形状。默认： 未指定
  • mapframe-geomask — 用作遮罩的维基数据项（遮罩边界外的区域变暗）。可以是特定的维基数据项（QID），或数据项的属性（例如，P17表示国家 (P17)，P131表示位于行政区划实体内 (P131)）。默认： 未指定
  • mapframe-switcher — 设置为auto或geomasks或zooms，以启用切换多个地图框架的功能（以Template:Switcher的风格）。默认： 未指定
    • auto — 以维基数据项的位置 (P276)和位于行政区划实体内 (P131)声称为遮罩进行切换，递归搜索。例如，数据项的城市、该城市的州以及该州的国家。
    • geomasks — 在mapframe-geomask参数中的维基数据项（QID）列表（以逗号分隔）指定的遮罩之间切换。
    • zooms — 在“zoomed in”/“zoomed midway”/“zoomed out”之间切换，其中“zoomed in”为默认缩放（最小值为3），“zoomed out”为1，而“zoomed midway”为平均值。
• 其他可选参数：
  • 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。默认： 未指定（即blank）
    • 也可以设置为blank以覆盖默认标记符号。
  • 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
  • mapframe-length_km或mapframe-length_mi或mapframe-area_km2或mapframe-area_mi2 — 通过输入对象的长度（以公里或英里为单位）或面积（以平方公里或平方英里为单位）来确定缩放级别。默认：未指定
  • mapframe-frame-coordinates或mapframe-frame-coord — 地图初始位置的备用坐标，使用使用{{coord}}模板。默认：衍生自项目坐标

模板数据部分，可插入Template:Infobox mapframe/doc#模板数据的内容来更新。

常见问题及解答

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（示例）

参见

• en:Wikipedia:Mapframe maps in infoboxes
• Module:Mapframe & Template:Maplink