模板:Maplink
此模板被引用於約3,500個頁面。 為了避免造成大規模的影響,所有對此模板的編輯應先於沙盒、測試樣例或您的沙盒上測試。 測試後無誤的版本可以一次性地加入此模板中,但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
此模板使用Lua語言: |
概要
本模板用於顯示地圖資訊的連結或是框架,支援資料格式如下:
- 儲存在共享資源中的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。
使用方法
基本使用
- 範例來自共享資源中的地圖格式數據(來源:Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):
{{maplink|from=}}
(使用from=
讀取.map
格式,不含前綴Data:
)
- 範例來自GeoJSON原始資料(來源:{{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}):
{{maplink|raw=}}
(使用GeoJSON,建議將資料來源嵌入自Wikipedia:Map data)
- 來自開放街圖(OSM):
- 想要顯示在框架中,加入此參數
|frame=yes
.
- 額外的參數可以用於客製化地圖
完整參數 – 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 linkinline,title
- Displays the inline link as well as the title linktitle,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:
- 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
- Example:
- 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
- Example:
- 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=
.
{{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
}}
重新導向
參見
- en:Wikipedia:Maplink,有關此模板和類似模板的資訊頁
- Template:Mapbox,該模板的衍生版本,僅顯示地圖連結
- Template:Infobox mapframe,更簡便的版本,用於資訊框
- Template:Attached KML
- Template:Rapid transit OSM map