模板:Infobox mapframe

File:Test Template Info-Icon - Version (2).svg 模板文件[檢視] [編輯] [歷史] [清除快取]

概要

本模板會生成地圖框架，以最精簡的方式套用進各式各樣的資訊框（Infobox）模板。模板僅適用於單一地理資料（點、線、面）。如果想要同時顯示多個地理資料或是更多進階資訊，請改用{{maplink}}模板。

請注意：如果未提供坐標，將從頁面的維基數據項中取得坐標。在這種情況下，如果未設置|point=，則除非有指定 (P402)，否則預設以點狀顯示座標。

• 沒有 (P402)的頁面參見Category:Infobox mapframe在維基數據上沒有OSM關係識別碼。
• 本模板不要直接用到正文中。

常見問題及解答見下方。

使用方法

注意：當在主命名空間使用時，不需要設定|id=參數（除非是要加入其他頁面資訊）。

如果需要某資訊框自動顯示地圖，可使用{{#invoke:Infobox mapframe|auto}}，詳見Module:Infobox mapframe/doc。

基本

{{Infobox mapframe}}

在不帶參數或僅使用|id=時，地圖將顯示點、線或面特徵，具體取決於維基數據和OpenStreetMap上的可用數據。

• 如果維基數據項未指定 (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)。

Geomask examples

使用連結到 (P17)聲明的項作為遮罩：

{{Infobox mapframe |id=Q3239281 |geomask=P17}}

使用專案 (Q1199)作為遮罩：

{{Infobox mapframe |id=Q3239281 |geomask=Q1199}}

根據對象長度或面積確定縮放

使用|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模板資料

<templatedata> { "params": { "mapframe": { "label": "顯示地圖框架", "description": "指定「yes」或「no」以顯示或隱藏地圖，這將覆蓋預設設置。", "example": "yes", "type": "string", "default": "no", "suggested": true }, "mapframe-caption": { "label": "地圖框架說明", "description": "地圖框架的說明文字。如果設置了mapframe-geomask，則預設為「在<<geomask標籤>>的位置」。", "type": "string" }, "mapframe-custom": { "label": "自訂地圖框架", "description": "使用自訂地圖代替自動地圖框架。請使用<maplink text="Map">[

]</maplink>模板（或其他可生成地圖框架的模板）或圖檔名稱。如果使用，後續的mapframe參數將被忽略。", "type": "wiki-template-name" }, "mapframe-id": { "aliases": [ "id", "qid" ], "label": "地圖框架維基數據項", "description": "要使用的維基數據項QID。", "type": "string", "default": "（當前頁面的專案）" }, "mapframe-coordinates": { "aliases": [ "mapframe-coord", "coordinates", "coord" ], "label": "地圖框架坐標", "description": "如果不使用維基數據上的坐標，則指定要使用的坐標。請使用模板。", "example": "", "type": "wiki-template-name", "default": "（維基數據上的坐標）" }, "mapframe-wikidata": { "label": "地圖框架顯示線/面", "description": "當坐標通過參數指定時，設置為「yes」以顯示維基數據項中的面/線要素（如果有的話）。", "type": "string", "suggestedvalues": [ "yes" ] }, "mapframe-point": { "label": "地圖框架點標記", "description": "覆蓋地圖框架點標記的顯示。設置為「none」以關閉點要素的顯示。設置為「on」以強制顯示點標記。", "type": "string", "suggestedvalues": [ "none", "on" ] }, "mapframe-line": { "label": "地圖框架線特徵", "description": "覆蓋地圖框架線特徵的顯示。設為「none」時關閉線特徵的顯示。", "type": "string", "suggestedvalues": [ "none" ] }, "mapframe-shape": { "label": "地圖框架面特徵", "description": "覆蓋地圖框架面特徵的顯示。設置為「none」以關閉顯示。設置為「inverse」以使用反轉形狀（geomask）代替常規形狀。", "type": "string", "suggestedvalues": [ "none" ] }, "mapframe-geomask": { "label": "地圖框架遮罩", "description": "用作遮罩的維基數據項（遮罩邊界外的區域變暗）。可以是特定的維基數據項（QID），或數據項的屬性（例如，P17表示國家 (P17)，P131表示所在行政領土實體 (P131)）。", "example": "Q100", "type": "wiki-page-name" }, "mapframe-frame-width": { "aliases": [ "mapframe-width" ], "label": "地圖框架寬度", "description": "地圖框架寬度，以像素為單位。", "type": "number", "default": "270" }, "mapframe-frame-height": { "aliases": [ "mapframe-height" ], "label": "地圖框架高度", "description": "地圖框架高度，以像素為單位。", "type": "number", "default": "200" }, "mapframe-shape-fill": { "label": "地圖框架面填充顏色", "description": "面特徵的填充顏色。", "type": "string", "default": "#606060" }, "mapframe-shape-fill-opacity": { "label": "地圖框架面填充不透明度", "description": "面特徵填充的不透明度，數值介於0和1之間。", "type": "number", "default": "0.5" }, "mapframe-stroke-color": { "aliases": [ "mapframe-stroke-colour" ], "label": "地圖框架線顏色", "description": "線特徵、面特徵輪廓的顏色。", "type": "string", "default": "#ff0000" }, "mapframe-stroke-width": { "label": "地圖框架線粗細", "description": "線特徵、面特徵輪廓的粗細。", "type": "number", "default": "5" }, "mapframe-marker": { "label": "地圖框架標記符號", "description": "用於坐標點標記的符號；具體選項參見mw:Help:Extension:Kartographer/Icons。", "example": "museum", "type": "string" }, "mapframe-marker-color": { "aliases": [ "mapframe-marker-colour" ], "label": "地圖框架標記顏色", "description": "點標記的背景顏色。", "type": "string", "default": "#5E74F3" }, "mapframe-geomask-stroke-color": { "aliases": [ "mapframe-geomask-stroke-colour" ], "label": "地圖框架遮罩輪廓顏色", "description": "遮罩輪廓的顏色。", "type": "string", "default": "#555555" }, "mapframe-geomask-stroke-width": { "label": "地圖框架遮罩輪廓粗細", "description": "遮罩輪廓的粗細。", "type": "number", "default": "2" }, "mapframe-geomask-fill": { "label": "地圖框架遮罩填充顏色", "description": "遮罩外部區域的填充顏色。", "type": "string", "default": "#606060" }, "mapframe-geomask-fill-opacity": { "label": "地圖框架遮罩填充不透明度", "description": "遮罩外部區域填充的不透明度，數值介於0和1之間。", "type": "number", "default": "0.5" }, "mapframe-zoom": { "label": "地圖框架縮放級別", "description": "設置縮放級別，從「1」（全球地圖）到 「18」（最大級別），用於無法根據對象長度或面積自動確定縮放級別的情況。", "example": "12", "type": "number", "default": "10" }, "mapframe-length_km": { "label": "地圖框架對象長度（公里）", "description": "以公里為單位的對象長度，用於自動確定縮放級別。請僅填寫長度或面積其中之一。 ", "type": "number" }, "mapframe-length_mi": { "label": "地圖框架對象長度（英里）", "description": "以英里為單位的對象長度，用於自動確定縮放級別。請僅填寫長度或面積其中之一。 ", "type": "number" }, "mapframe-area_km2": { "label": "地圖框架對象面積（平方公里）", "description": "以平方公里為單位的對象面積，用於自動確定縮放級別。請僅填寫長度或面積其中之一。 ", "type": "number" }, "mapframe-area_mi2": { "label": "地圖框架對象面積（平方英里）", "description": "以平方英里為單位的對象面積，用於自動確定縮放級別。請僅填寫長度或面積其中之一。 ", "type": "number" }, "mapframe-frame-coordinates": { "aliases": [ "mapframe-frame-coord" ], "label": "地圖框架初始位置坐標", "description": "地圖初始位置的備用坐標，使用模板。", "example": "", "type": "wiki-template-name" }, "mapframe-switcher": { "label": "地圖框架切換", "description": "設置為「auto」、「geomasks」或「zooms」，以啟用切換多個地圖框架的功能（以Template:Switcher的風格）。設置為auto — 以維基數據項的位置（P276）和所在行政領土實體（P131）陳述為遮罩進行切換，遞歸搜尋。例如，數據項的城市、該城市的州以及該州的國家。設置為geomasks — 在mapframe-geomask參數中指定的、以逗號分隔的維基數據項（QID）列表指定的遮罩之間切換。設置為zooms — 在「放大」/「中等縮放」/「縮小」之間切換，其中「放大」為預設縮放（最小為3），「縮小」為1，「中等縮放」為平均值。", "type": "string", "suggestedvalues": [ "auto", "geomasks", "zooms" ] } } } </templatedata>

常見問題及解答

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=參數（在使用Module:Infobox mapframe的資訊框的|mapframe-custom=參數內）的頁面顯示「執行指令碼的分配時間已到」的錯誤訊息。該怎麼辦？

A6：如果要處理的原始數據量過大，可能會顯示該逾時訊息。您可以嘗試將原始數據移至Commons（範例）或使用Special:ExpandTemplates將mapframe模板替換為等效的wikitext（範例）

上述文件嵌入自Template:Infobox mapframe/doc。（編輯 | 歷史）
編者可以在本模板的沙盒（編輯 | 差異）和測試樣例（編輯）頁面進行實驗。
請在/doc子頁面中添加分類。本模板的子頁面。