imported>Kcx36 来自 2025年11月28日 (五) 09:08

2025-11-28T09:08:15Z

新页面

{{NoteTA|G1=MediaWiki|G2=IT}}
{{Documentation subpage}}
{{High-use}}
{{Lua|Module:Mapframe}}
{{Uses Wikidata|P625}}
{{Sister project
|image=[[File:Openstreetmap logo.svg|40x40px]]
|text=This template uses the [[OpenStreetMap]] tag:
*'''''[http://wiki.openstreetmap.org/wiki/Key:wikidata wikidata]''''' (see [http://wiki.openstreetmap.org/wiki/Talk:Key:wikidata talk]; [https://taginfo.openstreetmap.org/keys/wikidata taginfo])
}}

== 概要 ==
本模板用於顯示地圖資訊的連結或是框架，支援資料格式如下：
*儲存在共享資源中的GeoJSON格式數據
*開放街圖中的線與多邊形圖徵
*提供或來自維基數據的坐標
*GeoJSON原始資料，最好从另一个页面嵌入
注意：
*當前GeoJSON檔案無法直接上傳，而是需要在[[c:|共享資源]]中創建一個命名空間為<code>Data:</code>，並且以<code>.map</code>為結尾的頁面——更多資訊請見[[mw:Help:Map Data]]。
*為了能正確顯示開放街圖（OSM）圖徵，請在所對應的OSM關聯輸入Wikidata鍵值（並且等待1或2日）——更多資訊請見[[mw:Help:Extension:Kartographer#External_data]]與[[mw:Help:Extension:Kartographer/OSM]]。

== 使用方法 ==
基本使用
*{{maplink|from=ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map|text=範例}}來自共享資源中的地圖格式數據{{small|1=(來源:[[c:Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map|Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map]])}}：
*:<code><nowiki>{{maplink|from=}}</nowiki></code>（使用<code>from=</code>讀取<code>.map</code>格式，不含前綴<code>Data:</code>）
*{{maplink|raw={{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}|text=範例}}來自GeoJSON原始資料{{small|1=(來源:<nowiki>{{</nowiki>[[Wikipedia:Map data/Main Roads Western Australia/Forrest Highway]]<nowiki>}}</nowiki>)}}：
*:<code><nowiki>{{maplink|raw=}}</nowiki></code>（使用GeoJSON，建議將資料來源嵌入自[[Wikipedia:Map data]]）
*來自開放街圖（OSM）：
**注意：必須將目標頁的維基數據項目（Wikidata）鏈結到OSM
**{{maplink|type=line|id=Q15907921|text=線段資料}}：<code><nowiki>{{maplink|type=line|id=}}</nowiki></code>
**{{maplink|type=shape|id=Q1094308|text=區域資料}}：<code><nowiki>{{maplink|type=shape|id=}}</nowiki></code>
**{{maplink|type=shape-inverse|id=Q1094308|text=區域資料（反選）}}：<code><nowiki>{{maplink|type=shape-inverse|id=}}</nowiki></code>
**{{maplink|type=point|id=Q1094308|text=點資料}}（座標）：
**:...Wikidata：<code><nowiki>{{maplink|type=point|id=}}</nowiki></code>
**:...特定座標：<code><nowiki>{{maplink|type=point|coord=}}</nowiki></code>（座標資料請使用{{tl|Coord}}模板）
*想要顯示在框架中，加入此參數{{para|frame|yes}}.
{{maplink|frame=yes|type=line|id=Q1094308|text=Mapframe example}}
{{-}}
*額外的參數可以用於客製化地圖
{{maplink|frame=yes|plain=yes|type=line|id=Q1094308|frame-width=200|frame-height=250|frame-long=19.1009|frame-lat=47.5001|zoom=8}}
{{-}}
完整參數 – data page
<syntaxhighlight lang="wikitext">
{{maplink
|display=
|from=
|zoom=
|text=
|icon=
}}
</syntaxhighlight>

完整參數 – raw data
<syntaxhighlight lang="wikitext">
{{maplink
|display=
|raw= 
|zoom=
|text=
|icon=
}}
</syntaxhighlight>

完整參數 – geoline/geoshape
<syntaxhighlight lang="wikitext">
{{maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}
</syntaxhighlight>

完整參數 – 點/座標
<syntaxhighlight lang="wikitext">
{{maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}
</syntaxhighlight>

== 參數 ==
===对于整体显示===
;display
:顯示模板。可用的參數；
::<code>inline</code> - Only displays the inline link (you can forego this, as it is the default)
::<code>title</code> - Only displays the title link
::<code>inline,title</code> - Displays the inline link as well as the title link
::<code>title,inline</code> - Same as above
;text
:顯示連結的文字或是地圖框架的描述，預設是"Map"
;icon
:設定<code>no</code>可以關閉地圖連結的圖示
;zoom
:放大等級，從<code>1</code>到<code>19</code>（愈大距離愈近），預設是自動取決於地圖 {{resize|(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
:設定<code>yes</code>會取代連結變成地圖框架
:;plain
::設定<code>yes</code>會顯示沒有外部框架（包含描述）的地圖('''text'''參數將會被忽略)
:;frame-align
::用於頁面對齊<code>left</code>，<code>center</code>，或是<code>right</code>。預設是<code>right</code>
:;frame-width
::地圖框架寬度，預設是<code>300</code>
:;frame-height
::地圖框架高度，預設是<code>200</code>
:;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 {{para|coord}} will be used (if set), or coordinates will be retrieved from Wikidata (if available, for either the item specified in {{para|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 <nowiki><maplink></nowiki> functionality not available via the other parameters. [[#The raw parameter|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 {{para|type2}}, {{para|id2}}, etc., the third feature {{para|type3}}, {{para|id3}}, etc., and so on.
;type
:Type of data. Valid values are:
::<code>line</code> – a geoline feature from OSM (e.g. a road)
::<code>shape</code> – a geoshape feature from OSM (e.g. a state or province)
::<code>shape-inverse</code> – a geomask feature from OSM (the inverse of a geoshape - allows an unobstructed view of the map beneath)
::<code>data</code> – a geoJSON data page on Commons (parameter is optional in this case)
::<code>point</code> – 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 {{para|from}} not set).
;from
:The JSON (.map) file from Commons to display (excluding the <code>Data:</code> 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 <code>#ff0000</code> (red)
;stroke-width
:Width for the lines used to draw the feature (for features from OSM); default is <code>6</code>
;coord
:Coordinates to display for a point feature. Use {{tl|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 ([[Web colors#Hex triplet|Hex triplet]]) specifying marker background color. Default is <code>5E74F3</code> ({{Color box|#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:
# Add parameter '''switch''' to specify labels for the different options: a list separated by either{{code|,}}, or {{code|;}} if the labels contain commas, or {{code|###}} if the labels contain semi-colons. Each label will be displayed with a prefix of "Show ".
#:Example: {{para|switch|zoomed out, zoomed mid, zoomed in}}
# For each parameter that is to be switched, set its value to {{kbd|SWITCH:}} followed by a list of values to switch between, again separated by {{code|,}} or {{code|;}} or {{code|###}}
#:Example: {{para|zoom|SWITCH:4,9,14}}
#:Parameters '''frame''', '''plain''', and '''text''' should not be switched
#Make sure each list has the same number of entries. The position of value in a {{kbd|SWITCH:}} list corresponds to the same position in the list of labels set in {{para|switch}}.
Example: {{mapframe|frame=yes|type=point|id=Q100|text=Boston|zoom=SWITCH:4,9,14|switch=zoomed out, zoomed mid, zoomed in}}
<syntaxhighlight lang="wikitext">{{mapframe|frame=yes|type=point|id=Q100|text=Boston|zoom=SWITCH:4,9,14|switch=zoomed out, zoomed mid, zoomed in}}</syntaxhighlight>
{{Clear}}

== 範例 ==
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
}}

<syntaxhighlight lang="wikitext">
{{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
}}
</syntaxhighlight>
{{-}}
多個地點
{{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 = [[高雄市]] [[楠梓區]]卓越路2號 [[燕巢區]]大學路1號
|type5 = point
|coord5 = {{Coord|22.772374|120.398095|}}
|title5 = 國立高雄科技大學燕巢校區
|description5 = [[高雄市]][[燕巢區]]深中路58號
}}

<syntaxhighlight lang="wikitext">
{{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 = [[高雄市]] [[楠梓區]]卓越路2號 [[燕巢區]]大學路1號
|type5 = point
|coord5 = {{Coord|22.772374|120.398095|}}
|title5 = 國立高雄科技大學燕巢校區
|description5 = [[高雄市]][[燕巢區]]深中路58號
}}
</syntaxhighlight>
{{-}}

{{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
}}
<syntaxhighlight lang="wikitext">{{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
}}
</syntaxhighlight>
{{-}}

{{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
}}
<syntaxhighlight lang="wikitext">
{{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
}}
</syntaxhighlight>
{{-}}

==常见问题及解答==
{{Maplink/doc/FAQ}}

== 重定向 ==
*{{tl|Mapframe}}
*{{tl|地图链接}}

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

<includeonly>{{sandbox other||

[[Category:經緯模板]]
[[Category:地圖模板]]
}}</includeonly>

Template:Maplink/doc - 版本历史

imported>Kcx36 来自 2025年11月28日 (五) 09:08