說明:Mapframe
 | 此幫助頁目前正依照Mapframe上的內容進行翻譯。 (2018年8月31日) |
本頁面將演示如何使用<mapframe/>和<maplink/>標籤顯示地圖。
開始使用
此段代碼將在頁面上插入一個簡單的交互式地圖（如右圖所示），您可以通過雙擊地圖或單擊右角的圖標來將這張地圖放大。
<mapframe text="旧金山市区" width="250" height="250" zoom="13" longitude="-122.3988" latitude="37.8013" lang="zh"/>
其中，width和height屬性用於設置地圖的寬度和長度，zoom屬性用於設置地圖的縮放比例。longitude和latitude屬性分別為地圖中心的經度和緯度，lang屬性為地圖顯示的語言。此外，您還可以使用align屬性設置地圖的控制地圖的對齊方式是居左（left）、居右（right）或是居中（center）。
<mapframe/>的用法
<mapframe><mapframe/>中的內容必須為空或者為一個有效的GejJSON數據格式，GejJsion數據可以由
GejJSON在線編輯器生成。
<mapframe text="旧金山博物馆" width="350" height="350" zoom="13" longitude="-122.39953994750977"
latitude="37.81032643553478">
{
"type": "Feature",
"geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
"properties": {
"title": "[[旧金山现代艺术博物馆]]",
"description": "[[File:Giant_Mirror_at_the_Exploratorium.jpeg|200px]]",
"marker-symbol": "museum",
"marker-size": "large",
"marker-color": "0050d0"
}
}
</mapframe>
框架
無框架地圖適合作為模板的一部分插入，而有框架地圖適合於直接插入到頁面中，無論是手動插入還是使用可視化編輯器。
- 若要插入沒有框架的地圖，請添加「frameless」屬性: <mapframe frameless ...>
- 若要添加標題，請使用text ="…"屬性。
注意:添加text屬性將強制顯示框架，即使您設置了frameless屬性。
<maplink>
將<mapframe>改為<maplink>會生成一個打開全屏地圖的連結37°48′37″N 122°23′58″W
<maplink zoom="13" longitude="-122.3995" latitude="37.8103" />
<maplink>可以通過設置"text"屬性來自定義連結的文本。 請點擊這裡
<maplink text="请点击这里" zoom="13" longitude="-122.3995" latitude="37.8103" />
<maplink>標籤可包含與<mapframe>標籤同樣的GejJSON數據。
<maplink> 的自動計數功能
<maplink> 會創建一個連結，當單擊時顯示全屏幕地圖。連結文本可以用text屬性設置。如果沒有設置屬性，連結文本為相應坐標 (如: 12°18′0″N 45°36′0″E)。如果使用了GeoJSON, 可設置marker-symbol鍵的值為「-number」或「-letter」。設置為「-number」的標地會以1,2,3,4...遞增， and <tvar|minusletter2><code 設置為「-letter」的標地會以字母表a,b,c,d...z的順序顯示。
<mapframe text="Several groups of automatic counters" width="350" height="350" zoom="13" longitude="-122.39902496337889"
latitude="37.80151060070086">
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"marker-symbol": "-number",
"marker-color": "302060"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41816520690917,
37.79097260220947
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-number",
"marker-color": "302060"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.40786552429199,
37.799654055191525
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-number",
"marker-color": "302060"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.40185737609865,
37.796262984039544
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-number",
"marker-color": "302060"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.38743782043457,
37.80535070427755
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-number",
"marker-color": "302060"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.38005638122557,
37.795449103799726
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-letter",
"marker-color": "208020"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.40941047668457,
37.81850557172186
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-letter",
"marker-color": "208020"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.40357398986815,
37.81280993744834
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-letter",
"marker-color": "208020"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.39842414855956,
37.8071138637568
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-number-bar",
"marker-color": "f01080"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.41181373596191,
37.78595317184089
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-number-bar",
"marker-color": "f01080"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.39542007446289,
37.787674400057654
]
}
},
{
"type": "Feature",
"properties": {
"marker-symbol": "-number-bar",
"marker-color": "f01080"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.38649368286131,
37.78401144262929
]
}
}
]
}
</mapframe>
If GeoJSON has more than one counter, the value of the first one will be shown as the link text. Optionally, editors may
add a suffix to have multiple counters on the page at the same time. This way <tvar|numbermuseum>‑number‑museum</> will have different counter from <tvar|numberbar>‑number‑bar</>.
It would make sense to use a distinct color for each counting group. All data added via <tvar|maplink><maplink></> will also be shown in all maps inserted with <tvar|mapframe><mapframe></>, unless the <tvar|group>group</> attribute is used.
</translate>
{{see
| name=Exploratorium | url=http://www.exploratorium.edu/
| lat=37.8013 | long=-122.3988
| content=A great museum
}}
<translate> could be expanded into </translate>
<maplink zoom=9 latitude=37.8013 longitude=-122.3988>
{
"type": "Feature",
"geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
"properties": {
"title": "Exploratorium",
"marker-color": "228b22",
"marker-symbol": "-number-see"
}
}
</maplink>
<translate>
The attributes <tvar|zoom>zoom</>, <tvar|latitude>latitude</>, and <tvar|
longitude>longitude</> control the location of the popup map. Use <tvar|text>text</> for the text of the link (could be any valid wikitext markup). Use <tvar|group>group</> to add the contents of this tag to the named group (see below).
Groups
</translate> Template:TNT
<translate> For use on the Wikivoyage project, there is a need to show a map whose data is defined somewhere else on the page. For
example, there may be multiple points of interest (POI) defined with <tvar|maplink><maplink></> tags, and one common map on the side of the page that shows them all.
The grouping concept allows editors to share data between multiple <tvar|mapframe><mapframe></> and <tvar|maplink><maplink></>
tags.
By default, the data inside the <tvar|mapframe><mapframe></> or <tvar|maplink><maplink></> tag is shown only for that one tag, and will not be shown anywhere else.
If <tvar|mapframe><mapframe></> or <tvar|maplink><maplink></> specify the <tvar|group>group="..."</> attribute, the
data inside those tags will be placed into a named group, together with all the other data by the same group name. As a
result, any tags with the same group name will show the same map data, and each tag may incrementally add data to the
group.
A tag may also show other groups, regardless if it belongs to a group or not, by specifying the <tvar|show>show="..."</> attribute. Comma-separated multiple group names may be specified. The group name may only
contain lower case English letters. This matrix shows what data will be shown for each tag. </translate>
<maplink> -- shows 1
<maplink group='food'> -- shows 2 4 8 10
<maplink group='bar' show='bar'> -- shows 3 9
<maplink group='food' show='bar'> -- shows 2 3 4 8 9 10
<maplink show='bar'> -- shows 3 5 9
<maplink show='food,bar'> -- shows 2 3 4 6 8 9 10
<mapframe> -- shows 7
<mapframe group='food'> -- shows 2 4 8 10
<mapframe group='bar' show='bar'> -- shows 3 9
<mapframe group='food' show='bar'> -- shows 2 3 4 8 9 10
<mapframe show='bar'> -- shows 3 9 11
<mapframe show='food,bar'> -- shows 2 3 4 8 9 10 12
== <translate> External data</translate> ==
<translate> In addition to drawing polygons using GeoJSON, you may also get outlines of the well known geographical objects by their
Wikidata ID if they are marked as such in the OpenStreetMap database. For example, Wikidata item for Alaska is
Q797, and we can draw it on the map by using "external data" reference. More than one ID may be specified
separated by a comma.</translate>
<translate> Note: Wikidata IDs are relatively new to the OSM community. There are only about 40,000 polygons with IDs. To add
more, visit https://www.openstreetmap.org/ and add Wikidata tag with the Q value. The data should
become available to Kartographer within 2 days.</translate>
<mapframe text="Alaska" width=300 height=300 zoom=3 longitude=-152.58 latitude=64.01>
{
"type": "ExternalData",
"service": "geoshape",
"ids": "Q797"
}
</mapframe>
GeoShape by Wikidata ID with properties
For external data, you can also add styles and titles, using the properties keyword.
<mapframe text="Interstate Highway I-696" width=300 height=300>
{
"type": "ExternalData",
"service": "geoline",
"ids": "Q2108",
"properties": {
"title": "Highway I-696",
"description": "[[File:I-696 near M-10 in 1988.jpg|200px]]",
"stroke": "#ffb100",
"stroke-width": 8
}
}
</mapframe>
The main style keys are: "stroke" (color), "stroke-width", "stroke-opacity", "fill" (color), "fill-opacity".
Combining multiple data types
You can also combine ExternalData, Feature, and FeatureCollection together in the same <mapframe> or <maplink>
element
<mapframe text="Caderousse city wall" width="300" height="300" zoom="15" longitude="4.75600" latitude="44.10200">
[
{
"type": "ExternalData",
"service": "geoshape",
"ids": "Q13518258",
"properties": {
"stroke": "#ffb100",
"stroke-width": 6,
}
},
{
"type": "Feature",
"geometry": { "type": "Point", "coordinates": [4.75566, 44.104498] },
"properties": {
"title": "Porte de Castellan"
}
},
{
"type": "Feature",
"geometry": { "type": "Point", "coordinates": [4.75829, 44.10258] },
"properties": {
"title": "Porte Léon Roche"
}
}
]
</mapframe>
GeoShapes via Wikidata Query
<translate> While this helps with the simple use cases when the Wikidata ID is well known, sometimes you may want to get a list of IDs
as a result of a Wikidata query. A SPARQL query gets a list of all US states in the ID column of the result, and geoshapes
service adds the geometrical outlines for each state. All other columns in the SPARQL query result become values in the
"properties" object. The "fill" column changes the color of the state. The "title" column shows state governor's name, and
"description" has wiki markup to show the state name and the governor's picture. To edit this query, copy the query
parameter after the "#" symbol at https://query.wikidata.org/#...:</translate>
<mapframe latitude="52" longitude="-110" zoom="3" width="500" height="500" text="Governors of US states with their party
affiliation">
{
"type": "ExternalData",
"service": "geoshape",
"query": "
SELECT ?id ?head
(SAMPLE(?img) as ?img)
(min(?partyId) as ?party)
(if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill)
(concat('[[wikipedia:', substr(str(?link),31,500), '{{!}}', ?headLabel, ']]') as ?title)
(concat(?stateLabel, '\\n', '[[File:', substr(str(?img), 52, 500), '{{!}}200px]]') as ?description)
WHERE {
?id wdt:P31 wd:Q35657 .
?id wdt:P6 ?head .
?head wdt:P102 ?party .
BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId)
SERVICE wikibase:label {
bd:serviceParam wikibase:language 'en' .
?head rdfs:label ?headLabel .
?id rdfs:label ?stateLabel .
}
OPTIONAL {
?head wdt:P18 ?img .
}
?link schema:about ?head .
?link schema:isPartOf <https://en.wikipedia.org/> .
} GROUP BY ?id ?head ?headLabel ?link ?stateLabel
"}
</mapframe>