模板:Infobox mapframe

模板文件[檢視] [編輯] [歷史] [清除快取]

概要

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

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

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

常見問題及解答見下方。

使用方法

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

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

基本

{{Infobox mapframe}}

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

• 如果維基數據項未指定OSM關係識別碼 (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模板資料

沒有描述。

模板參數[編輯模板資料]

參數		描述	類型	狀態
顯示地圖框架	mapframe	指定「yes」或「no」以顯示或隱藏地圖，這將覆蓋預設設置。 預設 no 範例 yes	字串	建議
地圖框架說明	mapframe-caption	地圖框架的說明文字。如果設置了mapframe-geomask，則預設為「在<<geomask標籤>>的位置」。	字串	非必填
自訂地圖框架	mapframe-custom	使用自訂地圖代替自動地圖框架。請使用{{maplink}}模板（或其他可生成地圖框架的模板）或圖檔名稱。如果使用，後續的mapframe參數將被忽略。	模板	非必填
地圖框架維基數據項	mapframe-id id qid	要使用的維基數據項QID。 預設 （當前頁面的專案）	字串	非必填
地圖框架坐標	mapframe-coordinates mapframe-coord coordinates coord	如果不使用維基數據上的坐標，則指定要使用的坐標。請使用{{Coord}}模板。 預設 （維基數據上的坐標） 範例 {{Coord|12.34|N|56.78|E}}	模板	非必填
地圖框架顯示線/面	mapframe-wikidata	當坐標透過參數指定時，設置為「yes」以顯示維基數據項中的面/線要素（如果有的話）。 建議值 yes	字串	非必填
地圖框架點標記	mapframe-point	覆蓋地圖框架點標記的顯示。設置為「none」以關閉點要素的顯示。設置為「on」以強制顯示點標記。 建議值 none on	字串	非必填
地圖框架線特徵	mapframe-line	覆蓋地圖框架線特徵的顯示。設為「none」時關閉線特徵的顯示。 建議值 none	字串	非必填
地圖框架面特徵	mapframe-shape	覆蓋地圖框架面特徵的顯示。設置為「none」以關閉顯示。設置為「inverse」以使用反轉形狀（geomask）代替常規形狀。 建議值 none	字串	非必填
地圖框架遮罩	mapframe-geomask	用作遮罩的維基數據項（遮罩邊界外的區域變暗）。可以是特定的維基數據項（QID），或數據項的屬性（例如，P17表示國家 (P17)，P131表示所在行政領土實體 (P131)）。 範例 Q100	頁面名稱	非必填
地圖框架寬度	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]]。 範例 museum	字串	非必填
地圖框架標記顏色	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 範例 12	數值	非必填
地圖框架對象長度（公里）	mapframe-length_km	以公里為單位的對象長度，用於自動確定縮放級別。請僅填寫長度或面積其中之一。	數值	非必填
地圖框架對象長度（英里）	mapframe-length_mi	以英里為單位的對象長度，用於自動確定縮放級別。請僅填寫長度或面積其中之一。	數值	非必填
地圖框架對象面積（平方公里）	mapframe-area_km2	以平方公里為單位的對象面積，用於自動確定縮放級別。請僅填寫長度或面積其中之一。	數值	非必填
地圖框架對象面積（平方英里）	mapframe-area_mi2	以平方英里為單位的對象面積，用於自動確定縮放級別。請僅填寫長度或面積其中之一。	數值	非必填
地圖框架初始位置坐標	mapframe-frame-coordinates mapframe-frame-coord	地圖初始位置的備用坐標，使用{{coord}}模板。 範例 {{Coord|12.35|N|56.71|E}}	模板	非必填
地圖框架切換	mapframe-switcher	設置為「auto」、「geomasks」或「zooms」，以啟用切換多個地圖框架的功能（以Template:Switcher的風格）。設置為auto — 以維基數據項的位置（P276）和所在行政領土實體（P131）陳述為遮罩進行切換，遞歸搜尋。例如，數據項的城市、該城市的州以及該州的國家。設置為geomasks — 在mapframe-geomask參數中指定的、以逗號分隔的維基數據項（QID）列表指定的遮罩之間切換。設置為zooms — 在「放大」/「中等縮放」/「縮小」之間切換，其中「放大」為預設縮放（最小為3），「縮小」為1，「中等縮放」為平均值。 建議值 auto geomasks zooms	字串	非必填

常見問題及解答

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（範例）

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