模組:Infobox mapframe/doc

該模組用於在資訊框中自動生成mapframe互動式地圖，編者只需輸入少量參數即可實現。

通用用法

直接使用模板{{Infobox mapframe}}，參照其文件說明即可。本模組也可匯入其他Lua模組使用。

在資訊框模板中嵌入

範例編輯: Template:Infobox prison、Template:Infobox prison/doc

修改模板

若要將mapframe地圖整合到現有的資訊框模板中，需在模板代碼的適當位置添加呼叫語句。地圖可以放置在資訊框的頂部附近（通常在圖片下方）或底部，參照以下範例修改模板即可（注意根據現有圖片或data參數的數量調整數字編號，如下方的4，或97、99）：

若置於資訊框頂部附近	若置於資訊框底部附近
| image4 = {{#invoke:Infobox mapframe|auto}} | caption4 = {{#invoke:Infobox mapframe|autocaption}}	| header97 = {{#if:{{{mapframe|}}}|地图}} | data98 = {{#invoke:Infobox mapframe|auto}} | data99 = {{#invoke:Infobox mapframe|autocaption}}

完成上述修改後，該資訊框模板即可支援Infobox mapframe的所有參數。

• 如果模板中呼叫了{{#invoke:Check for unknown parameters|check}}，只需在呼叫中添加|mapframe_args=y，即可將所有mapframe相關參數辨識為已知參數。
• 預設情況下，地圖功能是關閉的，即只有在條目呼叫資訊框時傳入|mapframe=yes參數才會顯示地圖。若希望預設開啟地圖，可以在#invoke呼叫中添加|onByDefault=yes，此時地圖預設顯示，除非條目呼叫時傳入|mapframe=no。
  • onByDefault也支援條件表達式，例如|onByDefault={{#if:{{{pushpin_map|}}}|no|yes}}，表示如果條目中使用了{{{pushpin_map|}}}參數，則關閉地圖功能，否則預設開啟。
• 在#invoke呼叫中可以指定參數的預設值。例如，若希望預設使用圖書館圖示作為標記，則寫為：{{#invoke:Infobox mapframe|auto|mapframe-marker=library}}，這樣除非在具體條目呼叫時指定了其他值，否則均使用該預設圖示。

更新模板文件

在資訊框模板的文件中，如需說明Infobox mapframe相關參數，可以使用{{Infobox mapframe/doc/parameters}}模板。該模板支援通過|參數名=值的形式指定預設值（如果在#invoke呼叫中指定了預設值）。以下是預設輸出：

延伸內容

• 基本參數：
  • mapframe — 指定yes或no以顯示或隱藏地圖，覆蓋預設值。預設：no
  • mapframe-caption — 地圖說明。預設： 空白（或如果設定了|mapframe-geomask=，則：「在<遮罩標籤>的位置」）
  • mapframe-custom — 使用自訂地圖代替自動地圖框架。請使用{{maplink}}模板（或其他可生成地圖框架的模板）或圖檔名稱。如果使用，後續的mapframe參數將被忽略。預設：未指定
  • mapframe-id或id或qid — 要使用的維基數據項QID。預設：當前頁面對應資料項
  • mapframe-coordinates或mapframe-coord或coordinates或coord — 指定的坐標，而不是維基數據上的坐標。使用{{Coord}}模板，例如：|coord={{Coord|12.34|N|56.78}}。預設：來自維基數據的坐標
  • mapframe-wikidata — 當設定了|coord=時，設為yes以顯示維基數據中的面/線特徵（如果有）。預設： 未指定
• 自訂顯示哪些特徵：
  • mapframe-point — 設為none時關閉點標記的顯示。設為on時強制顯示點標記。預設： 未指定
  • mapframe-line — 設為none時關閉線特徵的顯示。預設： 未指定
  • mapframe-shape — 設為none時關閉面特徵的顯示。設為inverse時使用反轉形狀（geomask）代替常規形狀。預設： 未指定
  • mapframe-geomask — 用作遮罩的維基數據項（遮罩邊界外的區域變暗）。可以是特定的維基數據項（QID），或資料項的屬性（例如，P17表示國家 (P17)，P131表示所在行政區 (P131)）。預設： 未指定
  • mapframe-switcher — 設定為auto或geomasks或zooms，以啟用切換多個地圖框架的功能（以Template:Switcher的風格）。預設： 未指定
    • auto — 以維基數據項的位置 (P276)和所在行政區 (P131)聲稱為遮罩進行切換，遞迴搜尋。例如，資料項的城市、該城市的州以及該州的國家。
    • geomasks — 在mapframe-geomask參數中的維基數據項（QID）列表（以逗號分隔）指定的遮罩之間切換。
    • zooms — 在「zoomed in」/「zoomed midway」/「zoomed out」之間切換，其中「zoomed in」為預設縮放（最小值為3），「zoomed out」為1，而「zoomed midway」為平均值。
• 其他可選參數：
  • mapframe-frame-width或mapframe-width — 框架寬度。預設：270
  • mapframe-frame-height或mapframe-height — 框架高度。預設：200
  • mapframe-shape-fill — 面特徵的填充顏色。預設：#606060
  • mapframe-shape-fill-opacity — 面特徵填充的不透明度，數值介於0和1之間。預設：0.5
  • mapframe-stroke-color或mapframe-stroke-colour — 線特徵、面特徵輪廓的顏色。預設：#ff0000
  • mapframe-stroke-width — 線特徵、面特徵輪廓的粗細。預設：5
  • mapframe-marker — 用於坐標點標記的符號；具體選項參見mw:Help:Extension:Kartographer/Icons。預設： 未指定（即blank）
    • 也可以設定為blank以覆蓋預設標記符號。
  • mapframe-marker-color或mapframe-marker-colour — 點標記的背景顏色。預設：#5E74F3
  • mapframe-geomask-stroke-color或mapframe-geomask-stroke-colour — 遮罩輪廓的顏色。預設：#555555
  • mapframe-geomask-stroke-width — 遮罩輪廓的粗細。預設：2
  • mapframe-geomask-fill — 遮罩外部區域的填充顏色。預設：#606060
  • mapframe-geomask-fill-opacity — 遮罩外部區域填充的不透明度，數值介於0和1之間。預設：0.5
  • mapframe-zoom — 設定縮放級別，從「1」（全球地圖）到 「18」（最大級別），用於無法根據對象長度或面積自動確定縮放級別的情況。預設：10
  • mapframe-length_km或mapframe-length_mi或mapframe-area_km2或mapframe-area_mi2 — 通過輸入對象的長度（以公里或英里為單位）或面積（以平方公里或平方英里為單位）來確定縮放級別。預設：未指定
  • mapframe-frame-coordinates或mapframe-frame-coord — 地圖初始位置的備用坐標，使用使用{{coord}}模板。預設：衍生自專案坐標

模板資料部分，可插入Template:Infobox mapframe/doc#模板資料的內容來更新。

常見問題及解答

Q1：為什麼來自OpenStreetMap的線狀或面狀要素沒有顯示？

A1：有幾種可能的原因：

• 根據mw:Help:Extension:Kartographer/OSM，OSM上的要素需要標記維基數據ID。僅在維基數據項上設定OSM關係識別碼 (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（範例）

參見

• en:Wikipedia:Mapframe maps in infoboxes
• Module:Mapframe & Template:Maplink