本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Geomap 面板
<a name="v9-panels-geomap"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Geomap 面板視覺化可讓您使用地理空間資料來檢視和自訂世界地圖。您可以設定各種浮水印樣式和地圖檢視設定，以輕鬆專注於資料的重要位置型特性。

## 地圖檢視
<a name="v9-panels-geomap-view"></a>

當儀表板載入時，地圖檢視會控制地圖的初始檢視。

**初始檢視**

初始檢視會設定第一次載入面板時 GeoMap 面板轉譯的方式。
+ **檢視**會在面板第一次載入時設定地圖的中心。
  + **適合資料** 根據映射層的資料範圍來調整映射檢視，並在資料變更時更新。
    + **資料**選項允許根據「所有圖層」、單一「圖層」或「最後一個值」從所選圖層的資料來選擇範圍。
    + 如果從圖**層**的單一「圖層」或「最後一個值」擬合資料，則可以選取圖層。
    + **填補**設定了超出資料範圍的相對百分比填補 （僅在查看「最後一個值」時不可用）。
    + **最大縮放**會在調整資料時設定最大縮放層級。
  + **座標**會根據下列項目設定地圖檢視：
    + **緯度**
    + **經度**
  + 預設檢視也可供使用，包括：
    + **(0°、0°)**
    + **北美洲**
    + **南美洲**
    + **歐洲**
    + **非洲**
    + **西亞**
    + **南亞**
    + **東南亞**
    + **東亞**
    + **澳洲**
    + **大洋洲**
+ **縮放**會設定初始縮放層級。

## 地圖層
<a name="v9-panels-geomap-layers"></a>

Geomap 視覺化支援顯示多個圖層。每個圖層都會決定如何在基礎地圖上方視覺化地理空間資料。

**類型**

在 Geomap 視覺化中，有三種地圖層類型可供選擇。
+ [標記圖層](#v9-panels-geomap-markers) 在每個資料點轉譯標記。
+ [熱度圖層](#v9-panels-geomap-heatmap) 視覺化資料的熱度圖。
+ [GeoJSON 層](#v9-panels-geomap-geojson) 會從 GeoJSON 檔案轉譯靜態資料。

目前還有五種層類型採用 Alpha。
+ [夜間/日間圖層 (Alpha)](#v9-panels-geomap-nightday) 會轉譯夜間或日間區域。
+ **最後一個點的圖示 (alpha)** 會在最後一個資料點轉譯圖示。
+ **動態 GeoJSON (alpha)** 會根據查詢結果來樣式 GeoJSON 檔案。
+ **Route (alpha)** 轉譯資料點做為路由。
+ [相片層 (Alpha)](#v9-panels-geomap-photos) 會在每個資料點轉譯相片。

**Layer 控制項**

圖層控制項可讓您建立圖層、變更其名稱、重新排序和刪除圖層。
+ **新增圖層**會為 Geomap 視覺化建立額外的可設定資料圖層。當您新增圖層時，系統會提示您選取圖層類型。您可以在面板組態期間隨時變更圖層類型。如需每個**圖層類型**的詳細資訊，請參閱上方的圖層類型一節。
+ 圖層控制項可讓您重新命名、刪除和重新排序面板的圖層。
  + **編輯圖層名稱** （鉛筆圖示） 會重新命名圖層。
  + **垃圾桶**會刪除 layer。
  + **重新排序** （六個點/抓取控點） 可讓您變更圖層順序。較高層上的資料會顯示在較低層上的資料上方。面板會在您拖放時更新圖層順序，以協助簡化選擇圖層順序。

您可以將多層資料新增至單一 Geomap 面板，以建立豐富且詳細的視覺化效果。

**位置**

Geomap 面板需要地理資料來源。此資料來自資料庫查詢，您的資料有四個映射選項。
+ **自動**搜尋位置資料。當您的查詢是以下列其中一個資料欄位名稱為基礎時，請使用此選項。
  + geohash：「geohash」
  + 緯度：「緯度」、「緯度」
  + 經度：「經度」、「lng」、「lon」
  + 查詢：「查詢」
+ **Coords** 指定您的查詢保留座標資料。系統會提示您從資料庫查詢中選取緯度和經度的數值資料欄位。
+ **Geohash** 指定您的查詢保留地理雜湊資料。系統會提示您從資料庫查詢中選取地理雜湊的字串資料欄位。
+ **查詢**指定您的查詢會保留需要對應至值的位置名稱資料。系統會提示您從資料庫查詢和 gazetteer 選取查詢欄位。Gazetteer 是用來將查詢資料映射至地理點的目錄。

## 標記圖層
<a name="v9-panels-geomap-markers"></a>

標記層可讓您將資料點顯示為不同的標記形狀，例如圓圈、方形、三角形、星星等。

標記有許多自訂選項。
+ **Marker Color** 會設定標記的顏色。預設值會將所有點`Single color`保留為單一顏色。根據資料點值和`Thresholds`區段中設定的閾值，有一個替代選項可以有多種顏色。
+ **Marker Size** 會設定標記的大小。預設值為 `Fixed size`，無論資料點為何，所有標記大小都相同。不過，也有選項可將圓圈擴展到對應的資料點。 `Min`和 `Max`標記大小必須設定，以便標記層可以在此範圍內擴展。
+ **Marker Shape** 可讓您選擇形狀、圖示或圖形，以協助為資料提供額外的視覺化內容。從 Grafana 隨附的資產中選擇，例如簡單形狀或 Unicon 程式庫。您也可以指定包含映像資產的 URL。影像必須是可擴展的向量圖形 (SVG)。
+ **填補不透明度**會設定每個標記的透明度。

## 熱度圖層
<a name="v9-panels-geomap-heatmap"></a>

熱度圖層叢集會建立各種資料點，以視覺化具有不同密度的位置。若要新增熱度圖層：

按一下 Data Layer 下的下拉式選單，然後選擇 `Heatmap`。

與 類似`Markers`，系統會提示您使用選項來決定要視覺化哪些資料點，以及如何視覺化這些資料點。
+ **權重值**會設定熱度圖叢集的強度。 會在所有資料點`Fixed value`中保持固定權重值。此值應介於 0\$11 的範圍內。與標記類似，下拉式清單中有一個替代選項，可根據資料值自動擴展權重值。
+ **Radius** 會設定熱度圖叢集的大小。
+ **Blur** 會設定每個叢集上的模糊程度。

## GeoJSON 層
<a name="v9-panels-geomap-geojson"></a>

GeoJSON layer 可讓您從檔案系統選取和載入靜態 GeoJSON 檔案。
+ **GeoJSON URL** 提供隨附於 Grafana 的 GeoJSON 檔案選擇。
+ **預設樣式**控制當以上規則不相符時要套用的樣式。
  + **顏色**設定預設樣式的顏色
  + **不透明度**設定預設不透明度
+ **樣式規則**會根據特徵屬性套用樣式
  + **規則**可讓您從 GeoJSON 檔案選取*功能*、*條件*和*值*，以定義規則。垃圾桶圖示可用來刪除目前的規則。
  + **顏色** 設定目前規則樣式的顏色
  + **不透明度**會設定目前規則的透明度層級
+ **新增樣式規則**會建立其他樣式規則。

## CARTO 層
<a name="v9-panels-geomap-carto"></a>

CARTO 層來自 [CARTO](https://carto.com/about-us/) Raster 基礎貼圖。

**選項**
+ **佈景主題**

   選擇**淺色**佈景主題、**深色**佈景主題或**自動**佈景主題。
+ **顯示標籤**會在地圖上方顯示國家/地區詳細資訊。
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## XYZ 並排圖層
<a name="v9-panels-geomap-xyz"></a>

XYZ 並排圖層是一般並排圖層的映射。

**注意**  
如需一般並排圖層的詳細資訊，請參閱[並排 Web Maps](https://en.wikipedia.org/wiki/Tiled_web_map) 和 [Open Street Map Tile Servers 的清單](https://wiki.openstreetmap.org/wiki/Tile_servers)。

**選項**
+ **URL 範本**
**注意**  
設定有效的並排伺服器 URL，例如 \$1z\$1/\$1x\$1/\$1y\$1：`https://tile.openstreetmap.org/{z}/{x}/{y}.png`。
+ 如果顯示在[地圖控制項](#v9-panels-geomap-controls)中，**屬性**會設定 layer 的參考字串
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## Open Street Map layer
<a name="v9-panels-geomap-osm"></a>

來自 [Open Street Map](https://www.openstreetmap.org/about) 的地圖，這是協作、免費的地理世界資料庫。

**選項**
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## ArcGIS 層
<a name="v9-panels-geomap-arcgis"></a>

[ArcGIS](https://services.arcgisonline.com/arcgis/rest/services) 層是來自 [ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS MapServer 的層。

**選項**
+ 要從下列映射類型中選取的**伺服器執行個體**。
  + World Street 地圖
  + 世界影像
  + 世界實體
  + 地形
  + 美國地形
  + 世界海洋
  + 自訂 MapServer （請參閱 [XYZ](#v9-panels-geomap-xyz) 進行格式化）
    + URL 範本
    + 歸因
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## 夜間/日間圖層 (Alpha)
<a name="v9-panels-geomap-nightday"></a>

夜間/日間圖層會根據目前時間範圍顯示夜間和日間區域。

**注意**  
如需詳細資訊，請參閱[ OpenLayers - DayNight 的擴充](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)功能。

**選項**
+ **顯示**從面板時間範圍切換時間來源
+ **夜間區域顏色**會挑選夜間區域的顏色
+ **顯示太陽**切換太陽圖示
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## 相片層 (Alpha)
<a name="v9-panels-geomap-photos"></a>

Photos layer 會在每個資料點轉譯相片。

**注意**  
如需詳細資訊，請參閱 [ OpenLayers 的延伸模組 - 影像相片樣式](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)。

**選項**
+ **影像來源欄位**

  選取包含下列任一格式的影像資料的字串欄位：
  + **影像 URLs**
  + **Base64 編碼**影像二進位 (`data:image/png;base64,…`)
+ **類型**

   選取影像周圍的影格樣式
  + **平方**
  + **Circle (圓形)**
  + **錨定**
  + **Folio**
+ **裁剪**切換影像是否裁剪以符合
+ **Shadow** 切換影像後方的方塊陰影
+ **邊界**設定影像周圍的邊界大小
+ **邊界顏色**設定影像周圍的邊界顏色
+ **Radius** 設定影像的整體大小，以像素為單位

## 地圖控制項
<a name="v9-panels-geomap-controls"></a>

地圖控制界面包含下列地圖資訊和工具浮水印的選項。

**Zoom**

本節說明每個縮放控制項。

*顯示縮放控制*

在左上角顯示縮放控制項。

*滑鼠滾輪縮放*

使用滑鼠滾輪開啟或關閉以放大或縮小。

**顯示屬性**

在地圖上顯示基礎貼圖層的屬性。

**顯示擴展**

在左下角顯示比例資訊。

**注意**  
以 【m】/【km】 顯示單位。

**顯示度量工具**

在右上角顯示度量工具。只有當此控制項開啟時，才會顯示測量。
+ **按一下**以開始測量
+ **繼續按一下**以繼續測量
+ **按兩下**以結束測量

**注意**  
當您變更測量類型或單位時，先前的測量會從映射中移除。  
如果控制項已關閉，然後重新開啟，則會顯示最新的測量結果。  
您可以透過按一下並拖曳來修改測量。

*長度*

取得幾何的球形長度。此長度是座標之間大圓距離的總和。對於分段幾何，長度是每個部分的長度總和。幾何假設為「EPSG：3857」。

您可以選擇下列單位進行長度測量：
+ **指標 (m/km)**
+ **英尺 （英尺）**
+ **英里 （英里）**
+ **海事英里 (nmi)**

*Area*

取得幾何的球形區域。假設多邊形邊緣是球體上大圓的區段，則會計算此區域。幾何假設為「EPSG：3857」。

您可以選擇下列單位進行區域測量：
+ **平方公尺 (m2)**
+ **平方公里 (km2)**
+ **平方英呎 (ft2)**
+ **平方英里 (mi2)**
+ **英數 （英數）**
+ **公頃 (ha)**

**顯示除錯**

在地圖的右上角顯示偵錯資訊。這對於偵錯或驗證資料來源非常有用。
+ **縮放**會顯示地圖目前的縮放層級。
+ **中心**會顯示地圖中心的目前**經度**和**緯度**。

**Tooltip (工具提示)**
+ 只有在按一下資料點時，**才會**顯示工具提示。
+ 當指標停留在資料點上時，**詳細資訊**會顯示工具提示。