文档 Grafana 文档 面板和可视化 可视化 地理地图

地理地图

地理地图允许您使用地理空间数据查看和自定义世界地图。如果您拥有包含位置信息的数据并希望将其显示在地图上，这是理想的可视化工具。

您可以配置和叠加地图图层，例如热力图和网络图，并混合使用自带的底图或您自己的自定义地图。这有助于您轻松地关注数据中基于位置的重要特征。

当地理地图获得焦点时，除了典型的鼠标控制外，您还可以使用方向键平移，或使用加号（+）和减号（-）键或图标放大缩小。

当您有实时变化的位置数据并希望使用自动刷新功能可视化元素移动的位置时，地理地图也非常有用。

如果您需要以下情况，可以使用地理地图可视化：

• 跟踪您的车队及其相关指标
• 显示数据中心或其他连接资产在网络中的位置和状态
• 在热力图中显示地理趋势
• 将您的位置的 HVAC 消耗或太阳能生产与太阳位置的关系可视化

配置地理地图可视化

以下视频提供了创建地理地图可视化的入门步骤。您将了解数据要求和注意事项、特殊自定义、预配置显示等等

使用 Grafana Play 试用一下

使用 Grafana Play，您可以探索并了解其工作原理，通过实际示例进行学习以加速您的开发。此功能可在地理地图示例中看到。

试用

支持的数据格式

要创建地理地图可视化，您需要包含位置信息字段的数据集。

支持的位置格式有：

• 纬度和经度
• Geohash
• 查找代码：国家、美国州或机场

要了解更多信息，请参阅位置模式。

地理地图还支持包含各种数据类型的额外字段，用于定义标签、数字、热力图大小和颜色等。

示例 - 纬度和经度

如果您计划使用纬度和经度坐标，数据集必须包含至少两个字段（或列）：一个名为 latitude（您也可以使用lat），一个名为 longitude（也可以是 lon 或 lng）。当您使用此命名约定，可视化将自动检测字段并显示元素。只要有一个纬度字段和一个经度字段，字段的顺序无关紧要。

如果您的纬度和经度字段命名不同，您可以指定它们，如位置模式部分所述。

示例 - Geohash

如果您的位置数据采用 geohash 格式，可视化需要至少一个包含位置数据的字段（或列）。

如果该字段名为 geohash，可视化将自动检测位置并显示元素。字段的顺序无关紧要，数据集可以包含多个其他数字、文本和时间字段。

如果您包含 geohash 位置数据的字段未按上述方式命名，您可以配置可视化以使用 geohash 并指定要使用的字段，具体说明见位置模式部分。

示例 - 查找代码

地理地图可视化可以根据国家、机场或美国州代码识别位置。

对于此配置，数据集必须包含至少一个包含位置代码的字段（或列）。

如果该字段名为 lookup，可视化将自动检测并根据国家代码显示点。

其他位置类型——机场代码或美国州代码——不会自动检测。

如果您想使用其他代码或为字段指定自定义名称，可以按照位置模式部分中的步骤操作。

配置选项

面板选项

在面板编辑器窗格的 面板选项 部分，设置面板标题和描述等基本选项，以及面板链接。要了解更多信息，请参阅配置面板选项。

地图视图选项

地图视图控制仪表盘加载时地图的初始视图。

初始视图

初始视图配置地理地图在面板首次加载时的渲染方式。

• 视图 - 设置面板首次加载时地图的中心。有关视图选择，请参阅本列表后的表格。
• 缩放 - 设置初始缩放级别。
• 使用当前地图设置 - 使用当前地图的设置来设置中心。

还提供以下默认视图：

共享视图

共享视图 选项允许您在同一仪表盘内关联多个地图可视化的移动和缩放操作。启用此选项的地图可视化会协同工作，当其中一个移动或缩放时，其他地图会随之联动，而未启用此选项的地图则保持独立。

地图图层选项

地理地图支持显示多个图层。每个图层决定您如何在底图之上可视化地理空间数据。

所有地图都需要设置以下三个选项：

• 图层类型
• 数据
• 位置模式

其他选项取决于您的地图图层类型，并在图层类型部分中描述。

图层控制允许您创建、重命名、重新排序和删除图层。

• 添加图层 为地理地图创建额外的、可配置的数据图层。当您添加图层时，系统会提示您选择图层类型。您可以在面板配置过程中的任何时候更改图层类型。有关每种图层类型的详细信息，请参阅上面的 图层类型 部分。
• 编辑图层名称（铅笔图标） 重命名图层。
• 垃圾桶 删除图层。
• 重新排序（六个点/拖动手柄） 允许您更改图层顺序。高层上的数据将显示在低层数据之上。可视化将在您拖放时更新图层顺序，以帮助简化选择图层顺序。

您可以向单个地理地图添加多个数据图层，以创建丰富、详细的可视化。

图层类型

地理地图中有七种地图图层类型可供选择。

• 标记 在每个数据点渲染一个标记。
• 热力图 可视化数据的热力图。
• GeoJSON 渲染来自 GeoJSON 文件的静态数据。
• 夜晚/白天 渲染夜晚/白天区域。
• 路线 (Beta) 将数据点渲染为路线。
• 照片 (Beta) 在每个数据点渲染一张照片。
• 网络图 (Beta) 从数据可视化网络图。
• Open Street Map 添加来自协作式免费世界地理数据库的地图。
• CARTO 底图 添加来自 CARTO 栅格底图的图层。
• ArcGIS MapServer 添加来自 ESRI ArcGIS MapServer 的图层。
• XYZ Tile layer 添加来自通用瓦片图层的地图。

还有两种实验性（或 Alpha）图层类型。

• 最后一个点处的图标 (Alpha) 在最后一个数据点渲染一个图标。
• 动态 GeoJSON (Alpha) 根据查询结果为 GeoJSON 文件设置样式。

要启用实验性图层。在您的配置文件中将 enable_alpha 设置为 true

复制

[panels]
enable_alpha = true

要使用 Docker 启用实验性图层，请运行以下命令：

复制

docker run -p 3000:3000 -e "GF_PANELS_ENABLE_ALPHA=true" grafana/grafana:<VERSION>

数据

地理地图需要从数据源查询收集的地理数据源，该查询可以返回多个数据集。默认情况下，Grafana 选择第一个数据集，但如果查询返回多个数据集，此下拉菜单允许您选择其他数据集。

位置模式

有四种选项可以映射所选查询返回的数据：

• 自动 自动搜索位置数据。当您的查询基于以下数据字段名称之一时，使用此选项：
  • geohash: “geohash”
  • latitude: “latitude”, “lat”
  • longitude: “longitude”, “lng”, “lon”
  • lookup: “lookup”
• 坐标 指定您的查询包含坐标数据。系统将提示您从数据库查询中选择纬度和经度的数字数据字段。
• Geohash 指定您的查询包含 geohash 数据。系统将提示您从数据库查询中选择 geohash 的字符串数据字段。
• 查找 指定您的查询包含需要映射到值的位置名称数据。系统将提示您从数据库查询中选择查找字段和一个地名录。地名录是用于将查询到的数据映射到地理位置点的目录。

标记图层

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

热力图层

热力图层将各种数据点聚类，以可视化具有不同密度位置。要添加热力图层：

点击 数据图层 下拉菜单并选择 热力图。

与 标记 类似，系统会提示您各种选项，以确定要可视化哪些数据点以及如何可视化它们。

GeoJSON 图层

GeoJSON 图层允许您从文件系统选择和加载静态 GeoJSON 文件。

可以在 GeoJSON 的“properties”对象中设置样式，支持以下几何类型：

面、多面

• “fill” - 面内部的颜色
• “fill-opacity” - 面内部的不透明度
• “stroke-width” - 面线条部分的宽度

点、多点

• “marker-color” - 点的颜色
• “marker-size” - 点的大小

线、多线

• “stroke” - 线的颜色
• “stroke-width” - 线的宽度

夜晚/白天图层

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

OpenLayers 扩展 - 日夜

路线图层 (Beta)

路线图层将数据点渲染为路线。

该图层还可以渲染带有箭头的路线。

OpenLayers 扩展 - 流线样式

照片图层 (Beta)

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

OpenLayers 扩展 - 图像照片样式

网络图层 (Beta)

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

您可以将节点图数据转换为网络图层

节点样式选项

边样式选项

Open Street Map 图层

来自协作式免费世界地理数据库的地图。

• 不透明度 从 0（透明）到 1（不透明）
• 显示工具提示 - 允许您切换该图层的工具提示。

关于 Open Street Map

CARTO 底图图层

CARTO 图层来自 CARTO 栅格底图。

• 主题
  • 自动
  • 浅色

  • 深色

• 显示标签 在地图顶部显示国家/地区详细信息。
• 不透明度 从 0（透明）到 1（不透明）
• 显示工具提示 - 允许您切换该图层的工具提示。

关于 CARTO

ArcGIS MapServer 图层

ArcGIS 图层来自 ESRI ArcGIS MapServer。

• 服务器实例 选择地图类型。
  • 世界街道地图

  • 世界影像图

  • 世界物理图

  • 地形图

  • 美国地形图

  • 世界海洋图

  • 自定义 MapServer（格式请参阅XYZ）
    • URL 模板
    • 署名
• 不透明度 从 0（透明）到 1（不透明）
• 显示工具提示 - 允许您切换该图层的工具提示。

更多信息

• ArcGIS 服务
• 关于 ESRI

XYZ Tile 图层

XYZ Tile 图层是来自通用瓦片图层的地图。

• URL 模板 - 设置有效的瓦片服务器 URL，包含 {z}/{x}/{y}，例如：https://tile.openstreetmap.org/{z}/{x}/{y}.png
• 署名 设置该图层的引用字符串，如果显示在地图控件中
• 不透明度 从 0（透明）到 1（不透明）

更多信息

• 瓦片网络地图维基百科
• Open Street Map 瓦片服务器列表

底图图层选项

底图图层为地图应用程序提供视觉基础。它通常包含全球覆盖的数据。提供多种底图选项，每种选项都有特定的配置选项来设置底图样式。

底图图层类型也可以作为图层添加。您可以指定不透明度。

地理地图中有四种底图图层类型可供选择。

• Open Street Map 添加来自协作式免费世界地理数据库的地图。
• CARTO 底图 添加来自 CARTO 栅格底图的图层。
• ArcGIS MapServer 添加来自 ESRI ArcGIS MapServer 的图层。
• XYZ Tile layer 添加来自通用瓦片图层的地图。

默认底图图层使用 CARTO 地图。您可以在 .ini 配置文件中定义自定义默认底图。

使用预配配置默认底图

您可以使用配置文件和 Grafana 的预配系统来配置默认底图。有关所有设置的更多信息，请参阅预配文档页面。

使用 JSON 配置选项 default_baselayer_config 来定义默认底图。当前有四种底图选项可供选择：carto, esri-xyz, osm-standard, xyz。以下是每种底图选项的一些预配示例。

• carto 加载 CartoDB 瓦片服务器。您可以选择 底图的 自动、深色 和 浅色 主题，并按如下所示进行设置。showLabels 标签决定 Grafana 是否在地图顶部显示国家/地区详细信息。这是一个示例：

ini 复制

geomap_default_baselayer = `{
  "type": "carto",
  "config": {
    "theme": "auto",
    "showLabels": true
  }
}`

• esri-xyz 加载 ESRI 瓦片服务器。已实现多个服务器实例以显示各种地图样式：world-imagery、world-physical、topo、usa-topo 和 ocean。custom 服务器选项允许您配置自己的 ArcGIS 地图服务器。这里有一些示例

世界影像自定义

ini 复制

geomap_default_baselayer = `{
  "type": "esri-xyz",
  "config": {
    "server": "world-imagery"
  }
}`

ini 复制

geomap_default_baselayer = `{
  "type": "esri-xyz",
  "config": {
    "server": "custom",
    "url": "[tile server url]",
    "attribution": "[tile server attribution]"
  }
}`

• osm-standard 加载 OpenStreetMap 瓦片服务器。无需额外配置，config 字段可以留空。这里有一个示例

ini 复制

default_baselayer_config = `{
  "type": "osm-standard",
  "config": {}
}`

• xyz 加载用户定义的自定义瓦片服务器。设置一个有效的瓦片服务器 url，使用 {z}/{x}/{y}，以便正确加载默认底图。这里有一个示例

ini 复制

default_baselayer_config = `{
  "type": "xyz",
  "config": {
    "attribution": "Open street map",
    "url": "https://tile.openstreetmap.org/{z}/{x}/{y}.png"
  }
}`

enable_custom_baselayers 允许您启用或禁用已实现的自定义开源底图。默认值为 true。

地图控件选项

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

显示缩放控件

在左上角显示缩放控件。对于没有鼠标的系统，此控件非常有用。

鼠标滚轮缩放

启用鼠标滚轮用于放大或缩小。

显示归因

显示底图图层的归因信息。

显示比例尺

在左下角显示以米 (m) 或千米 (km) 为单位的比例尺信息。

显示测量工具

在右上角显示测量工具。测量结果仅在此控件打开时显示。

• 单击 开始测量
• 继续单击 继续测量
• 双击 结束测量

当您更改测量类型或单位时，先前的测量将从地图上移除。如果控件关闭然后重新打开，则显示最近的测量结果。可以通过单击并拖动来修改测量。

长度

获取几何体的球面长度。此长度是坐标之间大圆距离的总和。对于多部分几何体，长度是每个部分长度的总和。几何体假定为‘EPSG:3857’投影。

• 公制 (m/km)
• 英尺 (ft)
• 英里 (mi)
• 海里 (nmi)

面积

获取几何体的球面面积。此面积假定多边形边缘是球体上的大圆弧段计算得出。几何体假定为‘EPSG:3857’投影。

• 平方米 (m²)
• 平方千米 (km²)
• 平方英尺 (ft²)
• 平方英里 (mi²)
• 英亩 (acre)
• 公顷 (ha)

显示调试信息

在右上角显示调试信息。这对于调试或验证数据源很有用。

• 缩放 显示当前地图缩放级别。
• 中心 显示当前地图中心的经度、纬度。

工具提示

• 无 仅在单击数据点时显示工具提示。
• 详细信息 在鼠标指针悬停在数据点上时显示工具提示。

标准选项

面板编辑器窗格中的标准选项允许您更改字段数据在可视化中的显示方式。设置标准选项时，更改会应用于所有字段或序列。要更精细地控制字段显示，请参阅配置覆盖。

要了解更多信息，请参阅配置标准选项。

数据链接和操作

数据链接允许您链接到其他面板、仪表盘和外部资源，同时保持源面板的上下文。您可以创建包含序列名称甚至光标下值的链接。

对于每个数据链接，设置以下选项

• 标题
• URL
• 在新标签页中打开

要了解更多信息，请参阅配置数据链接和操作。

值映射

值映射是一种用于更改数据在可视化中显示方式的技术。

对于每个值映射，设置以下选项

• 条件 - 选择映射到显示文本和（可选）颜色的内容
  • 值 - 特定值
  • 范围 - 数字范围
  • 正则 - 正则表达式
  • 特殊 - 特殊值，如 Null、NaN（非数字）或布尔值，如 true 和 false
• 显示文本
• 颜色（可选）
• 图标（仅限 Canvas）

要了解更多信息，请参阅配置值映射。

阈值

阈值是您为某个指标设置的值或限制，当达到或超过此值时会视觉上反映出来。阈值是一种基于查询结果对可视化进行条件样式设置和着色的方法。

对于每个阈值，设置以下选项

要了解更多信息，请参阅配置阈值。

字段覆盖

覆盖允许您自定义特定字段或序列的可视化设置。添加覆盖规则时，它会针对一组特定的字段，并允许您为该字段的显示方式定义多个选项。

从以下覆盖选项中选择

要了解更多信息，请参阅配置字段覆盖。