模板:Infobox mapframe/doc

概要

本模板會生成地圖框架，以最精簡的方式套用進各式各樣的資訊框（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)。

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

使用|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。 預設 (item for current page) 字串 非必填 地圖框架坐標 mapframe-coordinates mapframe-coord coordinates coord 指定的坐標，而不是維基數據上的坐標。使用{{Coord}}模板。 預設 （來自維基數據的坐標） 範例 {{Coord|12.34|N|56.78|E}} 模板 非必填 地圖框架顯示線/面 mapframe-wikidata 當設定了|coord=時，設為yes以顯示維基數據中的面/線特徵（如果有）。 範例 yes 字串 非必填 地圖框架點標記 mapframe-point 設為none時關閉點標記的顯示。設為on時強制顯示點標記。 字串 非必填 地圖框架線特徵 mapframe-line 設為none時關閉線特徵的顯示。 字串 非必填 地圖框架面特徵 mapframe-shape 設為none時關閉面特徵的顯示。設為inverse時使用反轉形狀（geomask）代替常規形狀。 字串 非必填 地圖框架寬度 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 用作遮罩的維基數據項（遮罩邊界外的區域變暗）。可以是特定的維基數據項（QID），或數據項的屬性（例如，P17表示國家 (P17)，P131表示所在行政領土實體 (P131)）。 範例 Q100 頁面名稱 非必填 地圖框架遮罩輪廓顏色 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 — 在「zoomed in」/「zoomed midway」/「zoomed out」之間切換，其中「zoomed in」為預設縮放（最小值為3），「zoomed out」為1，而「zoomed midway」為平均值。 字串 非必填