模板:Infobox mapframe/doc

概要

本模板会生成地图框架，以最精简的方式套用进各式各样的信息框（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)。

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

使用|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。 默认值 (item for current page) 字符串 可选 地图框架坐标 mapframe-coordinates mapframe-coord coordinates coord 指定的坐标，而不是维基数据上的坐标。使用{{Coord}}模板。 默认值 （来自维基数据的坐标） 示例值 {{Coord|12.34|N|56.78|E}} 模板 可选 地图框架显示线/面 mapframe-wikidata 当设置了|coord=时，设为yes以显示维基数据中的面/线特征（如果有）。 示例值 yes 字符串 可选 地图框架点标记 mapframe-point 设为none时关闭点标记的显示。设为on时强制显示点标记。 字符串 可选 地图框架线特征 mapframe-line 设为none时关闭线特征的显示。 字符串 可选 地图框架面特征 mapframe-shape 设为none时关闭面特征的显示。设为inverse时使用反转形状（geomask）代替常规形状。 字符串 可选 地图框架宽度 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 用作遮罩的维基数据项（遮罩边界外的区域变暗）。可以是特定的维基数据项（QID），或数据项的属性（例如，P17表示国家 (P17)，P131表示所在行政领土实体 (P131)）。 示例值 Q100 页面名称 可选 地图框架遮罩轮廓颜色 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 — 在“zoomed in”/“zoomed midway”/“zoomed out”之间切换，其中“zoomed in”为默认缩放（最小值为3），“zoomed out”为1，而“zoomed midway”为平均值。 字符串 可选