Template:Maplink

<mapframe zoom="9" text="Mapframe" height="200" latitude="35.90" longitude="-106.56" width="300">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink"},"type":"ExternalData","title":"ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map","service":"page"}</mapframe> <maplink text="Maplink">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink"},"type":"ExternalData","title":"ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map","service":"page"}</maplink>

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

概要

本模板用於顯示地圖資訊的連結或是框架，支援資料格式如下：

• 儲存在共享資源中的GeoJSON格式數據
• 開放街圖中的線與多邊形圖徵
• 提供或來自維基數據的坐標
• GeoJSON原始資料，最好从另一个页面嵌入

注意：

• 當前GeoJSON檔案無法直接上傳，而是需要在共享資源中創建一個命名空間為Data:，並且以.map為結尾的頁面——更多資訊請見mw:Help:Map Data。
• 為了能正確顯示開放街圖（OSM）圖徵，請在所對應的OSM關聯輸入Wikidata鍵值（並且等待1或2日）——更多資訊請見mw:Help:Extension:Kartographer#External_data與mw:Help:Extension:Kartographer/OSM。

使用方法

基本使用

• <maplink text="範例">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink"},"type":"ExternalData","title":"ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map","service":"page"}</maplink>來自共享資源中的地圖格式數據(來源:Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map)：

  {{maplink|from=}}（使用from=讀取.map格式，不含前綴Data:）

• <maplink text="範例">{{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}</maplink>來自GeoJSON原始資料(來源:{{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}})：

  {{maplink|raw=}}（使用GeoJSON，建議將資料來源嵌入自Wikipedia:Map data）

• 來自開放街圖（OSM）：
  • 注意：必須將目標頁的維基數據項目（Wikidata）鏈結到OSM
  • <maplink text="線段資料">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink"},"type":"ExternalData","service":"geoline","ids":"Q15907921"}</maplink>：{{maplink|type=line|id=}}
  • <maplink text="區域資料">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink"},"type":"ExternalData","service":"geoshape","ids":"Q1094308"}</maplink>：{{maplink|type=shape|id=}}
  • <maplink text="區域資料（反選）">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink"},"type":"ExternalData","service":"geomask","ids":"Q1094308"}</maplink>：{{maplink|type=shape-inverse|id=}}
  • （座標）：

    ...Wikidata：{{maplink|type=point|id=}}

    ...特定座標：{{maplink|type=point|coord=}}（座標資料請使用{{Coord}}模板）

• 想要顯示在框架中，加入此參數|frame=yes.

<mapframe height="200" text="Mapframe example" width="300">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink"},"type":"ExternalData","service":"geoline","ids":"Q1094308"}</mapframe>

• 額外的參數可以用於客製化地圖

<mapframe zoom="8" frameless="1" height="250" latitude="47.5001" longitude="19.1009" width="200">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink"},"type":"ExternalData","service":"geoline","ids":"Q1094308"}</mapframe>

完整參數 – data page

{{maplink
|display=
|from=
|zoom=
|text=
|icon=
}}

完整參數 – raw data

{{maplink
|display=
|raw= <!-- preferably {{Wikipedia:Map data/subpage}} -->
|zoom=
|text=
|icon=
}}

完整參數 – geoline/geoshape

{{maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}

完整參數 – 點/座標

{{maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

參數

对于整体显示

display

顯示模板。可用的參數；

inline - Only displays the inline link (you can forego this, as it is the default)

title - Only displays the title link

inline,title - Displays the inline link as well as the title link

title,inline - Same as above

text

顯示連結的文字或是地圖框架的描述，預設是"Map"

icon

設定no可以關閉地圖連結的圖示

zoom

放大等級，從1到19（愈大距離愈近），預設是自動取決於地圖
(Note that automatically determined zoom level does not work for mapframe maps except when previewing the page – see phab:T193455)

Mapframe parameters (only work with inline display)

frame

設定yes會取代連結變成地圖框架

plain

設定yes會顯示沒有外部框架（包含描述）的地圖(text參數將會被忽略)

frame-align

用於頁面對齊left，center，或是right。預設是right

frame-width

地圖框架寬度，預設是300

frame-height

地圖框架高度，預設是200

frame-latitude

(or frame-lat)

Optional - alternate latitude coordinate for initial placement of map

frame-longitude

(or frame-long)

Optional - alternate longitude coordinate for initial placement of map

If frame latitude and longitude are not set by parameters, then coordinates in |coord= will be used (if set), or coordinates will be retrieved from Wikidata (if available, for either the item specified in |id= parameter or for the page the template is placed on)

Raw GeoJSON

raw

Raw GeoJSON (preferably transcluded from a subpage of Wikipedia:Map data) as well as <maplink> functionality not available via the other parameters. See below for more information.

对于各种特征

Multiple features can be displayed on a single map. For each additional feature, add a sequential number to the end of the parameter name. For example, the second uses parameters like |type2=, |id2=, etc., the third feature |type3=, |id3=, etc., and so on.

type

Type of data. Valid values are:

line – a geoline feature from OSM (e.g. a road)

shape – a geoshape feature from OSM (e.g. a state or province)

shape-inverse – a geomask feature from OSM (the inverse of a geoshape - allows an unobstructed view of the map beneath)

data – a geoJSON data page on Commons (parameter is optional in this case)

point – a point feature (coordinates)

id

(or ids)

Wikidata id (Q-number) of the point feature, Wikidata id that the OSM line/shape feature is tagged with. Separate multiple ids with a comma. Defaults to the current page's Wikidata id (if |from= not set).

from

The JSON (.map) file from Commons to display (excluding the Data: prefix)

title

Title of the feature (for features from OSM), displayed when the feature is clicked on; default is the page title

description

Description of the feature (for features from OSM), displayed when the feature is clicked on; optional

stroke-color

(or stroke-colour)

Color code for the color used to draw the feature (for features from OSM); default is #ff0000 (red)

stroke-width

Width for the lines used to draw the feature (for features from OSM); default is 6

coord

Coordinates to display for a point feature. Use {{Coord}} template to specify coordinates. If not set, coordinates will be retrieved from Wikidata.

marker

Name of Maki marker image to display at the point feature. See mw:Maps/Icons for options. If not set, a plain marker will be shown without an image.

marker-color

(or marker-colour)

Color code (Hex triplet) specifying marker background color. Default is 5E74F3 ( )

多地图切换

An option for Template:Switcher-style switching of multiple mapframes, where specified parameters like zoom, or frame coordinates, or a shape's item id are switched between different values. When using, ensure the number of values in each list are the same.

Instructions:

1. Add parameter switch to specify labels for the different options: a list separated by either,, or ; if the labels contain commas, or ### if the labels contain semi-colons. Each label will be displayed with a prefix of "Show ".

   Example: |switch=zoomed out, zoomed mid, zoomed in

2. For each parameter that is to be switched, set its value to SWITCH: followed by a list of values to switch between, again separated by , or ; or ###

   Example: |zoom=SWITCH:4,9,14

   Parameters frame, plain, and text should not be switched

3. Make sure each list has the same number of entries. The position of value in a SWITCH: list corresponds to the same position in the list of labels set in |switch=.

Example:

{{mapframe|frame=yes|type=point|id=Q100|text=Boston|zoom=SWITCH:4,9,14|switch=zoomed out, zoomed mid, zoomed in}}

範例

Multiple features allow you to:

• Use external data from both Wikimedia Commons and OpenStreetMap together
• Apply different styles to different external data features from OpenStreetMap
• Include multiple links to external data from Wikimedia Commons

單一地點

{{maplink
|text = [[高雄高工]]地理位置
|frame = yes
|zoom = 15
|type = point
|coord = {{Coord|22.649769|N|120.326540|E}}
|title = [[高雄市立高雄高級工業職業學校]]
|description = 簡稱高雄高工、雄工、KIHS，位於高雄市三民區的一所公立高職。
|type2 =shape
|id2 =Q15907921
|plain = yes
}}

多個地點

{{maplink
|text = [[國立高雄科技大學]]各校區分布圖
|frame = yes
|zoom = 10
|frame-width = 250
|frame-height = 400
|frame-align = right
|type3 = point
|coord3 = {{Coord|22.608539|120.272677|}}
|title3 = 國立高雄科技大學旗津校區
|description3 = [[高雄市]][[旗津區]]中洲三路482號
|type2 = point
|id2=Q6973907
|coord2 = {{Coord|22.649114|120.326640|}}
|title2 = 國立高雄科技大學建工校區
|description2 = [[高雄市]][[三民區]]建工路415號
|type = point
|coord = {{Coord|22.724591|120.314605|}}
|title = 國立高雄科技大學楠梓校區
|description = [[高雄市]][[楠梓區]]海專路142號
|type4 = point
|coord4 = {{Coord|22.754484|120.332831|}}
|title4 = 國立高雄科技大學第一校區
|description4 = [[高雄市]]<br>[[楠梓區]]卓越路2號<br>[[燕巢區]]大學路1號
|type5 = point
|coord5 = {{Coord|22.772374|120.398095|}}
|title5 = 國立高雄科技大學燕巢校區
|description5 = [[高雄市]][[燕巢區]]深中路58號
}}

{{Maplink|frame=yes
|type=shape|id=Q3495894|title=Shape|description=Description of shape
|type2=line|id2=Q1318331|title2=Line|description2=Description of line
|type3=point|coord3={{coord|32|S|116|E}}|title3=Point|description3=Description of point
}}

{{Maplink|frame=yes|plain=yes|frame-width=250|frame-height=280|zoom=6|frame-lat=29.185|frame-long=76.225
|type=shape-inverse|id=Q1174|title=Haryana
|type2=point|id2=Q200663|stroke-width=3|title2=Faridabad
}}

常见问题及解答

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=参数的页面显示“运行脚本的分配时间已到”的错误消息。该怎么办？

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

重定向

• {{Mapframe}}
• {{地图链接}}

參見

• en:Wikipedia:Maplink，有关此模板和类似模板的信息页
• Template:Mapbox，该模板的衍生版本，仅显示地图链接
• Template:Infobox mapframe，更简便的版本，用于信息框
• Template:Attached KML
• Template:Rapid transit OSM map

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