本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Geomap 面板
****
本文档主题专为支持 **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 面板可视化让您可以使用地理空间数据，查看和自定义世界地图。通过配置各种叠加样式和地图视图设置，您可以轻松聚焦于数据中基于位置的重要特征。
## 地图视图
地图视图控制控制面板加载时地图的初始视图。
**初始视图**
初始视图配置首次加载 GeoMap 面板时面板的呈现方式。
+ **视图**设置面板首次加载时地图的中心。
+ **适应数据**根据地图图层的数据范围适应地图视图，并在数据发生变化时更新。
+ **数据**选项允许根据所选图层中的“所有图层”、单个“图层”或“最后一个值”的数据选择范围。
+ 如果适应来自单个“图层”或图层“最后一个值”的数据，则可以选择**图层**。
+ **填充**以超出数据范围的相对百分比设置填充（仅在查看“最后一个值”时不可用）。
+ **最大缩放**设置适应数据时的最大缩放级别。
+ **坐标**根据以下因素设置地图视图：
+ **纬度**
+ **经度**
+ 还提供了默认视图，包括：
+ **（0°, 0°）**
+ **北美洲**
+ **南美洲**
+ **欧洲**
+ **非洲**
+ **西亚**
+ **南亚**
+ **东南亚**
+ **东亚**
+ **澳大利亚**
+ **大洋洲**
+ **缩放**设置初始缩放级别。
## 地图图层
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 文件的样式。
+ **路由（alpha）**将数据点渲染为路由。
+ [照片图层（Alpha）](#v9-panels-geomap-photos) 在每个数据点渲染一张照片。
**图层控件**
图层控件允许您创建图层、更改图层名称、重新排序和删除图层。
+ **添加图层**可为 Geomap 可视化创建附加的可配置数据图层。添加图层时，系统会提示您选择图层类型。在面板配置过程中，您可以随时更改图层类型。有关每种图层类型的详细信息，请参阅上面的**图层类型**部分。
+ 通过图层控件，您可以重命名、删除和重新排序面板上的图层。
+ **编辑图层名称**（铅笔图标）可重命名图层。
+ **垃圾桶**可删除图层。
+ **重新排序**（六个点/抓取手柄）允许更改图层顺序。较高图层的数据将显示在较低图层的数据之上。拖放时，面板将更新图层顺序，以帮助简化图层顺序的选择。
您可以向单个 Geomap 面板添加多层数据，以创建丰富、详细的可视化效果。
**位置**
Geomap 面板需要一个地理数据来源。这些数据来自数据库查询，数据有四种映射选项。
+ **自动**可自动搜索位置数据。当您的查询基于以下数据字段名称之一时，请使用此选项。
+ geohash: “geohash”
+ latitude: “latitude”, “lat”
+ longitude: “longitude”, “lng”, “lon”
+ lookup: “lookup”
+ **坐标**指定查询包含坐标数据。系统会提示您从数据库查询中选择纬度和经度的数值数据字段。
+ **地理哈希**指定您的查询包含地理哈希数据。系统会提示您从数据库查询中为地理哈希选择字符串数据字段。
+ **查找**指定查询包含需要映射为地理位置的名称数据。系统将提示您从数据库查询和地名录中选择查找字段。地名录是用于将查询到的数据映射到地理点的目录。
## 标记图层
标记图层允许您将数据点显示为不同的标记形状，如圆形、方形、三角形、星形等。
标记有许多自定义选项。
+ **标记颜色**可配置标记的颜色。默认的 `Single color` 会使所有点保持为单一颜色。还有一个备选选项，可根据数据点得值和在 `Thresholds` 部分设置的阈值设置多种颜色。
+ **标记大小**可配置标记的大小。默认值为 `Fixed size`，即无论数据点的情况如何，所有标记的大小都相同。但是，也有一个选项可以根据对应的数据点缩放圆圈的大小。需要设置 `Min` 和 `Max` 标记大小，以便标记图层可以在这些范围内缩放。
+ **标记形状**允许您选择形状、图标或图形，以帮助为数据提供额外的可视化上下文。从 Grafana 中包含的资源中选择，例如简单形状或 Unicon 库。您也可以指定包含图像资源的 URL。图像必须是可缩放向量图形（SVG）。
+ **填充不透明度**可配置每个标记的透明度。
## 热图图层
热图图层将各种数据点聚类，以直观显示不同密度的位置。添加热图图层：
单击数据图层下的下拉菜单并选择 `Heatmap`。
与 `Markers` 类似，系统会提示您使用各种选项来确定要可视化的数据点以及可视化的方式。
+ **权重值**用于配置热图集群的强度。`Fixed value` 在所有数据点保持恒定的权重值。该值范围应为 0\$11。与标记类似，下拉列表中还有一个备选选项，可以根据数据值自动缩放权重值。
+ **半径**用于配置热图集群的大小。
+ **模糊**用于配置每个集群的模糊程度。
## GeoJSON 图层
通过 GeoJSON 图层，可从文件系统中选择并加载静态 GeoJSON 文件。
+ **GeoJSON URL** 提供了 Grafana 附带的 GeoJSON 文件供您选择。
+ **默认样式**控制当上述规则不匹配时要应用的样式。
+ **颜色**可配置默认样式的颜色
+ **不透明度**可配置默认的不透明度
+ **样式规则**根据特征属性应用样式
+ **规则**允许您从 GeoJSON 文件中选择*特征*、*条件*和*值*来定义规则。垃圾桶图标可用于删除当前规则。
+ **颜色**可为当前规则配置样式的颜色
+ **不透明度**配置当前规则的透明度级别
+ **添加样式规则**可创建其他样式规则。
## CARTO 图层
CARTO 图层来自 [CARTO](https://carto.com/about-us/) 栅格底图。
**Options**
+ **主题**
选择一个主题，可以是**浅色**主题、**深色**主题或**自动**主题。
+ **显示标签**在地图顶部显示国家/地区的详细信息。
+ **不透明度**从 0（透明）到 1（不透明）
## XYZ 切片图层
XYZ 切片图层是来自通用切片图层的地图。
**注意**
有关通用切片图层的更多信息，请参阅 [Web 切片地图](https://en.wikipedia.org/wiki/Tiled_web_map)和 [Open Street Map 切片服务器列表](https://wiki.openstreetmap.org/wiki/Tile_servers)。
**Options**
+ **URL 模板**
**注意**
设置有效的切片服务器 url，例如 \$1z\$1/\$1x\$1/\$1y\$1：`https://tile.openstreetmap.org/{z}/{x}/{y}.png`。
+ **属性**设置图层的参考字符串（如果显示在[地图控件](#v9-panels-geomap-controls)中）
+ **不透明度**从 0（透明）到 1（不透明）
## Open Street Map 图层
来自 [Open Street Map](https://www.openstreetmap.org/about) 的地图，这是一个协作式的免费地理世界数据库。
**Options**
+ **不透明度**从 0（透明）到 1（不透明）
## ArcGIS 图层
A [rcGIS](https://services.arcgisonline.com/arcgis/rest/services) 图层是来自 [ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS MapServer 的图层。
**Options**
+ **服务器实例**，可从以下地图类型中选择。
+ World Street Map
+ World Imagery
+ World Physical
+ Topographic
+ USA Topographic
+ World Ocean
+ 自定义 MapServer （有关格式，请参阅 [XYZ](#v9-panels-geomap-xyz)）
+ URL 模板
+ 属性
+ **不透明度**从 0（透明）到 1（不透明）
## 夜间/白天图层（Alpha）
夜间/白天图层根据当前时间范围显示夜间和白天区域。
**注意**
有关更多信息，请参阅 [ OpenLayers -的扩展 DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)。
**Options**
+ **显示**从面板时间范围切换时间来源
+ **夜间区域颜色**选择夜间区域的颜色
+ **显示太阳**切换太阳图标
+ **不透明度**从 0（透明）到 1（不透明）
## 照片图层（Alpha）
照片图层在每个数据点渲染一张照片。
**注意**
有关更多信息，请参阅 [ OpenLayers -图像照片样式的扩展程序](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)。
**Options**
+ **图像来源字段**
选择包含以下任一格式的图像数据的字符串字段：
+ **图像 URLs**
+ **Base64 编码**图像二进制（`data:image/png;base64,…`）
+ **类型**
选择图像周围的框架样式
+ **Square**
+ **Circle**
+ **锚定**
+ **对开**
+ **裁剪**切换（裁剪图像以适合尺寸）
+ **阴影**切换图像背后的方框阴影
+ **边框**设置图像周围的边框大小
+ **边框颜色**设置图像周围的边框颜色
+ **半径**设置图像的整体大小（像素）
## 地图控件
地图控件界面包含以下地图信息和工具叠加选项。
**Zoom**
本节介绍了每个缩放控件。
*显示缩放控件*
在左上角显示缩放控件。
*鼠标滚轮缩放*
使用鼠标滚轮进行放大或缩小来打开或关闭。
**显示属性**
显示地图上底图图层的属性。
**显示刻度**
在左下角显示刻度信息。
**注意**
以 [m]/[km] 为单位显示。
**显示测量工具**
在右上角显示测量工具。仅当此控件打开时，才会显示测量值。
+ **单击**开始测量
+ **继续单击**继续测量
+ **双击**结束测量
**注意**
更改测量类型或单位后，先前的测量值将从地图上删除。
如果控件关闭后又重新打开，则会显示最新的测量值。
单击并拖动测量值可以对其进行修改。
*长度*
获取几何形状的球面长度。该长度是坐标之间的大圆距离之和。对于多部分几何形状，长度是每个部分的长度之和。假设几何形状位于“EPSG:3857”中。
您可以选择以下长度测量单位：
+ **公制（m/km）**
+ **英尺（ft）**
+ **英里（mi）**
+ **海里（nmi）**
*领域*
获取几何形状的球面面积。计算此面积时，假设多边形的边是球体上大圆的线段。假设几何形状位于“EPSG:3857”中。
您可以选择以下面积测量单位：
+ **平方米（m²）**
+ **平方千米（km²）**
+ **平方英尺（ft²）**
+ **平方英里（mi²）**
+ **英亩（acre）**
+ **公顷（ha）**
**显示调试**
在地图右上角显示调试信息。这对于调试或验证数据来源很有用。
+ **缩放**显示地图的当前缩放级别。
+ **中心**显示地图中心的当前**经度**和**纬度**。
**Tooltip**
+ **无**仅当单击数据点时才显示工具提示。
+ **详细信息**当指针悬停在数据点上时显示工具提示。