本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Geomap
<a name="v10-panels-geomap"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

Geomap 让您可以使用地理空间数据，查看和自定义世界地图。通过配置各种叠加样式和地图视图设置，您可以轻松聚焦于数据中基于位置的重要特征。

**注意**  
您可以在提供的底图图层之上添加自己的地理空间数据。 AWS底图图层必须全部来自。[https://tiles.maps.search-services.aws.a2z.com](https://tiles.maps.search-services.aws.a2z.com)

![\[显示 Grafana 中 geomap 可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-panel-example.png)


## 地图视图
<a name="v10-panels-geomap-view"></a>

地图视图控制控制面板加载时地图的初始视图。

**初始视图**

初始视图配置首次加载 GeoMap 面板时面板的呈现方式。
+ **视图**设置面板首次加载时地图的中心。
  + **适应数据**根据地图图层的数据范围适应地图视图，并在数据发生变化时更新。
    + **数据**选项允许根据*所有图层*、单个*图层*或所选图层的*最后一个值*来选择范围。
    + 如果适应来自单个*图层*或图层*最后一个值*的数据，则可以选择**图层**。
    + **填充**以超出数据范围的相对百分比设置填充（仅在查看*最后一个值*时不可用）。
    + **最大缩放**设置适应数据时的最大缩放级别。
  + **坐标**根据以下因素设置地图视图：
    + **纬度**
    + **经度**
  + 还提供了默认视图，包括：
    + **（0°, 0°）**
    + **北美洲**
    + **南美洲**
    + **欧洲**
    + **非洲**
    + **西亚**
    + **南亚**
    + **东南亚**
    + **东亚**
    + **澳大利亚**
    + **大洋洲**
+ **缩放**设置初始缩放级别。

## 地图图层
<a name="v10-panels-geomap-layers"></a>

Geomap 支持显示多个图层。每个图层决定了如何基于基础地图，实现地理空间数据的可视化。

**类型**

Geomap 可视化中有三种地图层类型可供选择。
+ [标记图层](#v10-panels-geomap-markers) 在每个数据点渲染一个标记。
+ [热图图层](#v10-panels-geomap-heatmap) 可视化数据的热图。
+ [GeoJSON 图层](#v10-panels-geomap-geojson) 渲染 GeoJSON 文件中的静态数据。
+ [夜间/白天图层（Alpha）](#v10-panels-geomap-nightday) 渲染夜间或白天区域。
+ [路由图层（预览）](#v10-panels-geomap-route) 将数据点渲染为路径。
+ [照片图层（预览）](#v10-panels-geomap-photos) 在每个数据点渲染一张照片。
+ [网络图层（预览）](#v10-panels-geomap-network) 根据数据可视化网络图。

还有两种实验性（或 alpha）图层类型。
+ **最后一个点的图标（alpha）**在最后一个数据点渲染一个图标。
+ **动态 GeoJSON（alpha）**根据查询结果设置 GeoJSON 文件的样式。

**注意**  
在公共预览中标记为*预览*或 *alpha* 的图层。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

**图层控件**

图层控件允许您创建图层、更改图层名称、重新排序和删除图层。
+ **添加图层**可为 geomap 创建附加的可配置数据图层。添加图层时，系统会提示您选择图层类型。在面板配置过程中，您可以随时更改图层类型。
+ 通过图层控件，您可以重命名、删除和重新排序面板上的图层。
  + **编辑图层名称**（铅笔图标）可重命名图层。
  + **垃圾桶**可删除图层。
  + **重新排序**（六个 dots/grab 手柄）允许您更改图层顺序。较高图层的数据将显示在较低图层的数据之上。拖放时，可视化将更新图层顺序，以帮助简化图层顺序的选择。

您可以向单个 geomap 面板添加多层数据，以创建丰富、详细的可视化效果。

**位置**

Geomap 需要一个地理数据来源。这些数据来自数据库查询，数据有四种映射选项。
+ **自动**可自动搜索位置数据。当您的查询基于以下数据字段名称之一时，请使用此选项。
  + *地理哈希*：`geohash`
  + *纬度*：`latitude`、`lat`
  + *经度*：`longitude`、`lng`、`lon`
  + *查找*：`lookup`
+ **坐标**指定查询包含坐标数据。系统会提示您从数据库查询中选择纬度和经度的数值数据字段。
+ **地理哈希**指定您的查询包含地理哈希数据。系统会提示您从数据库查询中为地理哈希选择字符串数据字段。
+ **查找**指定查询包含需要映射为地理位置的名称数据。系统将提示您从数据库查询和地名录中选择查找字段。地名录是用于将查询到的数据映射到地理点的目录。

## 标记图层
<a name="v10-panels-geomap-markers"></a>

标记图层允许您将数据点显示为不同的标记形状，如圆形、方形、三角形、星形等。

标记有许多自定义选项。
+ **大小**可配置标记的大小。默认值为 `Fixed size`，无论数据如何，所有标记的大小都相同；但还有一个选项可以根据与所选字段对应的数据来调整标记的大小。必须设置 `Min` 和 `Max` 标记大小，以便标记图层可以在此范围内缩放。
+ **符号**允许您选择符号、图标或图形，以帮助为数据提供额外的可视化上下文。从 Grafana 中包含的资源中选择，例如简单符号或 Unicon 库。您也可以指定包含图像资源的 URL。图像必须是可缩放向量图形（SVG）。
+ **符号垂直对齐**可配置符号相对于数据点的垂直对齐方式。请注意，首先围绕数据点应用符号的旋转角度，然后相对于符号的旋转应用垂直对齐。
+ **符号水平对齐**可配置符号相对于数据点的水平对齐方式。请注意，首先围绕数据点应用符号的旋转角度，然后相对于符号的旋转应用水平对齐。
+ **颜色**可配置标记的颜色。默认 `Fixed color` 将所有标记设置为特定颜色。还可以根据选定的字段数据点值和**标准选项**部分设置的颜色方案来设置条件颜色。
+ **填充不透明度**可配置每个标记的透明度。
+ **旋转角度**可配置每个标记的旋转角度。默认为**固定值**，这将使所有标记旋转到相同的角度，无论数据如何；但还有一个选项可以根据与所选字段对应的数据来设置标记的旋转。
+ **文本标签**可为每个标记配置文本标签。
+ **显示图例**允许切换图层的图例。
+ **显示工具提示**允许切换图层的工具提示。

## 热图图层
<a name="v10-panels-geomap-heatmap"></a>

热图图层将各种数据点聚类，以直观显示不同密度的位置。

![\[显示在 Grafana 中使用 geomap 可视化热图示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-heatmap-example.png)


添加热图图层：

选择数据图层下的下拉菜单并选择 `Heatmap`。

与 `Markers` 类似，系统会提示您使用各种选项来确定要可视化的数据点以及可视化的方式。
+ **权重值**用于配置热图集群的强度。**固定值**使所有数据点的权重值保持恒定。该值范围应为 0-1。与标记类似，下拉列表中还有一个备选选项，可以根据数据值自动缩放权重值。
+ **半径**用于配置热图集群的大小。
+ **模糊**用于配置每个集群的模糊程度。
+ **不透明度**可配置每个集群的不透明度。
+ **显示工具提示**允许切换图层的工具提示。

## GeoJSON 图层
<a name="v10-panels-geomap-geojson"></a>

通过 GeoJSON 图层，可从文件系统中选择并加载静态 GeoJSON 文件。
+ **GeoJSON URL** 提供了 Grafana 附带的 GeoJSON 文件供您选择。
+ **默认样式**控制当上述规则不匹配时要应用的样式。
  + **颜色**可配置默认样式的颜色
  + **不透明度**可配置默认的不透明度
+ **样式规则**根据特征属性应用样式
  + **规则**允许您从 GeoJSON 文件中选择*特征*、*条件*和*值*来定义规则。垃圾桶图标可用于删除当前规则。
  + **颜色**可为当前规则配置样式的颜色
  + **不透明度**可配置当前规则的透明度级别。
+ **添加样式规则**可创建其他样式规则。
+ **显示工具提示**允许切换图层的工具提示。

## 夜间/白天图层（Alpha）
<a name="v10-panels-geomap-nightday"></a>

夜间/白天图层根据当前时间范围显示夜间和白天区域。

![\[显示在 Grafana 中使用 geomap 可视化夜间/白天图层示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-day-night-example.png)


**Options**
+ **显示**从面板时间范围切换时间来源。
+ **夜间区域颜色**选择夜间区域的颜色。
+ **显示太阳**切换太阳图标。
+ **不透明度**从 0（透明）到 1（不透明）。
+ **显示工具提示**允许切换图层的工具提示。

**注意**  
有关更多信息，请参阅 [ OpenLayers -的扩展 DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)。

## 路由图层（预览）
<a name="v10-panels-geomap-route"></a>

路由图层将数据点渲染为路径。

**注意**  
路径图层当前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

![\[显示在 Grafana 中使用 geomap 可视化路由图层示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-route-layer-example.png)


**Options**
+ **大小**设置路由粗细。默认为固定值。选择字段数据后，您可以设置字段数据可以缩放的最小值和最大值范围。
+ **颜色**设置路由颜色。默认设置为固定颜色，也可以将颜色与字段数据绑定。
+ **填充不透明度**可配置路由的不透明度。
+ **文本标签**可为每个路由配置文本标签。
+ **箭头**可配置箭头样式，使其按数据顺序沿路由显示。
  + **无**
  + **正向**
  + **反向**
+ **显示工具提示**允许切换图层的工具提示。

**注意**  
有关更多信息，请参阅 [ OpenLayers -流线样式的扩展](http://viglino.github.io/ol-ext/examples/style/map.style.gpxline.html)。

## 照片图层（预览）
<a name="v10-panels-geomap-photos"></a>

照片图层在每个数据点渲染一张照片。

**注意**  
照片图层当前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

**Options**
+ **图像来源字段**允许选择一个字符串字段，其中包含 Base64 编码的二进制图像数据（`data:image/png;base64,...`）。
+ **类型**可设置图像周围的框架样式。从中选择：
  + **Square**
  + **Circle**
  + **锚定**
  + **对开**
+ **裁剪**切换（裁剪图像以适合尺寸）。
+ **阴影**切换图像背后的方框阴影。
+ **边框**设置图像周围的边框大小。
+ **边框颜色**设置图像周围的边框颜色。
+ **半径**设置图像的整体大小（像素）。
+ **显示工具提示**允许切换图层的工具提示。

**注意**  
有关更多信息，请参阅 [ OpenLayers -图像照片样式的扩展程序](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)。

## 网络图层（预览）
<a name="v10-panels-geomap-network"></a>

网络图层渲染网络图。该图层支持节点图可视化所支持的相同数据格式，并在节点数据中添加了地理空间数据。地理空间数据用于在地图上定位和渲染节点。

**注意**  
网络图层当前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

![\[显示 Grafana 中 geomap 网络可视化示例的图像。\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/images/viz/geomap-network-layer-example.png)


**注意**  
网络图层当前为公共预览版。Grafana Labs 提供的支持有限，在该功能正式发布之前可能会发生重大更改。

**Options**
+ **箭头**设置每条边的箭头显示方向，向前表示从来源到目标。从中选择：
  + **无**
  + **正向**
  + **反向**
  + **二者**
+ **显示图例**允许切换图层的图例。图例仅支持节点数据。
+ **显示工具提示**允许切换图层的工具提示。

**节点样式**
+ **大小**可配置节点的大小。默认为**固定大小**，这将使所有节点大小相同，无论数据如何；但还有一个选项可以根据与所选字段对应的数据来调整节点大小。必须设置**最小**和**最大**节点大小，以便节点可以在此范围内缩放。
+ **颜色**可配置节点的颜色。默认为**固定颜色**，将所有节点设置为特定颜色。还可以根据选定的字段数据点值和**标准选项**部分设置的颜色方案来设置条件颜色。
+ **符号**允许您选择符号、图标或图形，以帮助为数据提供额外的可视化上下文。从 Grafana 中包含的资源中选择，例如简单符号或 Unicon 库。您也可以指定包含图像资源的 URL。图像必须是可缩放向量图形（SVG）。
+ **填充不透明度**可配置每个节点的透明度。
+ **旋转角度**可配置每个节点的旋转角度。默认为**固定值**，这将使所有节点旋转到相同的角度，无论数据如何；但还有一个选项可以根据与所选字段对应的数据来设置节点的旋转。
+ **文本标签**可为每个节点配置文本标签。

**边样式**
+ **大小**可配置边的线宽。默认为**固定大小**，这将使所有边线宽度相同，无论数据如何；但还有一个选项可以根据与所选字段对应的数据来调整边的大小。必须设置**最小**和**最大**边大小，以使边可以在此范围内缩放。
+ **颜色**可配置边的颜色。默认为**固定颜色**，将所有边设置为特定颜色。还可以根据选定的字段数据点值和**标准选项**部分设置的颜色方案来设置条件颜色。
+ **填充不透明度**可配置每个边的透明度。
+ **文本标签**可为每个边配置文本标签。

## CARTO 图层
<a name="v10-panels-geomap-carto"></a>

Amazon Managed Grafana 不支持 CARTO 图层。

## XYZ 切片图层
<a name="v10-panels-geomap-xyz"></a>

Amazon Managed Grafana 不支持 XYZ 切片图层。

## Open Street Map 图层
<a name="v10-panels-geomap-osm"></a>

Amazon Managed Grafana 不支持 Open Street Map 图层（默认的基础地图除外）。

## ArcGIS 图层
<a name="v10-panels-geomap-arcgis"></a>

Amazon Managed Grafana 不支持 ArcGIS 图层。

## 地图控件
<a name="v10-panels-geomap-controls"></a>

地图控件部分包含各种地图信息和工具叠加选项。

**Zoom**

缩放控件选项。

*显示缩放控件*

在左上角显示缩放控件。

*鼠标滚轮缩放*

使用鼠标滚轮进行放大或缩小来打开或关闭。

**显示属性**

显示地图上底图图层的属性。

**显示刻度**

在左下角显示刻度信息。

**注意**  
以 [m]/[km] 为单位显示。

**显示测量工具**

在右上角显示测量工具。仅当此控件打开时，才会显示测量值。
+ **单击**开始测量
+ **继续单击**继续测量
+ **双击**结束测量

**注意**  
更改测量类型或单位后，先前的测量值将从地图上删除。  
如果控件关闭后又重新打开，则会显示最新的测量值。  
单击并拖动测量值可以对其进行修改。

*长度*

获取几何形状的球面长度。该长度是坐标之间的大圆距离之和。对于多部分几何形状，长度是每个部分的长度之和。假设几何形状位于“EPSG:3857”中。

您可以选择以下长度测量单位：
+ **公制（m/km）**
+ **英尺（ft）**
+ **英里（mi）**
+ **海里（nmi）**

*领域*

获取几何形状的球面面积。计算此面积时，假设多边形的边是球体上大圆的线段。假设几何形状位于“EPSG:3857”中。

您可以选择以下面积测量单位：
+ **平方米（m²）**
+ **平方千米（km²）**
+ **平方英尺（ft²）**
+ **平方英里（mi²）**
+ **英亩（acre）**
+ **公顷（ha）**

**显示调试**

在地图右上角显示调试信息。这对于调试或验证数据来源很有用。
+ **缩放**显示地图的当前缩放级别。
+ **中心**显示地图中心的当前**经度**和**纬度**。

**Tooltip**
+ **无**仅当单击数据点时才显示工具提示。
+ **详细信息**当指针悬停在数据点上时显示工具提示。