For the complete DHIS2 documentation index, see llms.txt.

使用地图应用¶

关于地图应用¶

“地图”应用于2.29版本中推出，旨在取代原有的GIS应用，提供更直观、更友好的用户界面。自2.34版本起，其地图引擎基于WebGL 技术，能够同时在地图上显示数千个要素。

注意

“地图”应用需要 WebGL 支持。请访问 get.webgl.org，以确认您的浏览器中 WebGL 是否正常工作，或排查显示问题。

使用“地图”应用，您可以叠加多个图层，并从不同的底图中进行选择。支持的图层类型包括主题地图、事件、被追踪实体、设施、组织单位边界，以及 Earth Engine 数据（如人口、海拔或气候指标）。您可以为要素添加标签、搜索和筛选数据，并将地图保存或与其他用户共享，或将其下载为图像。保存的地图可添加到**仪表板**应用中的仪表板中。主题图层还可与 **数据可视化**应用集成，让您将相同数据以图表形式打开。

注意

要在地图应用中使用预定义的图例，您需要先在 元数据管理 应用中创建它们。

图层面板{ #layers-panel }¶

工作区左侧的**图层面板**显示了当前地图的图层概览：

随着通过**(+) 添加图层**按钮添加图层，这些图层将在此处进行排列和管理面板。
**底图**卡片始终显示在面板底部。参见有关可用选项，请参阅底图。
图层面板右上角的小箭头按钮可用于隐藏或显示。

面板中的每张卡片代表一个图层。卡片顶部设有用于通过鼠标重新排列图层顺序的拖拽手柄、图层标题，以及用于折叠或展开卡片的箭头。卡片中部显示图层图例（如适用）。卡片底部从左到右依次为：

“编辑”（铅笔）按钮可打开图层配置对话框。
一个眼睛图标用于切换图层的可见性。
滑块用于调整图层的透明度。
“更多操作”（三个点）按钮提供了其他选项，包括显示或隐藏数据表、下载图层数据、复制图层以及删除图层。

地图控件{ #map-controls }¶

地图上的 + 和 - 按钮可分别用于放大或缩小地图。该鼠标滚轮的缩放功能是连续的，可让您将地图完美地调整到与内容相符的大小。
**旋转地图**按钮（三角箭头）可让您旋转和倾斜地图，以增强查看您的数据。按住该按钮（或按住键盘上的 Control 键）的同时移动鼠标以调整地图视图。再次单击该按钮可重置视图。
全屏（四个箭头）可让您以全屏模式查看地图。要退出全屏模式，请点击再次点击该按钮，或按下键盘上的Esc键。
放大至内容（带边框的放大镜图标）会自动调整缩放级别，并地图中心位置，以便将地图上的数据置于焦点位置。
搜索（放大镜图标）可用于在地图上搜索并跳转至指定位置。
使用**直尺**按钮，您可以测量地图上的距离和面积。
在地图上右键单击，即可显示该位置的经纬度。

位于左上角附近的**“文件”**按钮可用于打开和保存地图。请参阅使用地图文件菜单以获取更多详细信息。
“文件”按钮旁边的**“下载”**按钮可让您将当前地图下载为PNG格式图片。
右上角的**“解释”**按钮会在右侧打开一个解释面板，该面板位于工作区。有关更多信息，请参阅查看解释。

建立新地图¶

打开“地图”应用时，界面会显示一个空白的地图画布，并默认选中底图。如果已有地图打开，请通过文件 > 新建创建新地图。您可以随时通过图层面板中的底图卡片更改底图（参见底图）。

要添加图层，请点击左上角的 (+) 添加图层 按钮。此时将打开图层选择对话框：

简体中文（大陆）

可用的图层类型包括：

主题：可视化数据值（指标或数据元素）按组织单位汇总。
活动：显示来自活动或追踪程序的单个活动。
被追踪的实体：显示被追踪的实体及其地图上的关系。
设施：根据设施的类型，以图标形式显示设施坐标。
组织单位：显示组织单位的边界。

此外，Google Earth Engine 可能提供若干图层（例如人口、海拔或气候指标），以及其他外部服务。如果已配置 Google Earth Engine API 密钥，则可使用各种 Google Earth Engine 图层来源（参见文档)）。

注意

地图应用管理员 可以：

通过 管理可用图层来源 按钮，选择可供其他用户使用的 Google Earth Engine 图层来源。

在“维护”应用中添加外部图层来源。

底图{ #using_maps_basemaps }¶

底图是用于显示数据图层的背景地图。您可以通过图层面板底部的**底图**卡片来选择和配置底图。

默认提供以下底图：

OSM Light：一款基于 OpenStreetMap 数据的简约浅色地图。这是默认选项底图。
OSM Dark：一款基于 OpenStreetMap 数据的深色主题地图。当您的数据颜色各层都很明亮。
OSM Fiord：一款基于 OpenStreetMap 数据的、色调柔和的蓝色系地图。
OSM 详细版：包含更多的地图要素和地名。
Sentinel-2 EOX：无云卫星图像，呈现地球的自然色景象 10米分辨率的地表。

如果系统管理员已配置 Bing Maps 或 Azure Maps API 密钥，则每个提供商将额外提供四种底图。这两个提供商都提供相同的四种样式，其名称前缀均为提供商名称——例如，Bing Road 和 Azure Road：

道路：显示道路、边界和地点。
深色：一款深色主题的路线图。当数据图层的颜色较亮时，此主题非常实用。
航拍：卫星图像和详细的航拍图像。
航拍图标注：带有地名标注的航拍图像。

地图应用管理员 还可以通过 “维护”应用添加外部底图。这些底图会与默认底图一起显示在底图卡片中。

底图图层在图层面板中以卡片形式显示。该卡片列出了可用的底图，其中当前选中的底图会以高亮显示。底部的控件可用于切换底图的可见性并调整其透明度。

注意

Bing Maps 即将停用。请参阅 Bing Maps 博客了解停用公告。如需迁移至 Azure Maps，请参阅 Bing Maps 迁移概述。

管理专题图层{ #using_maps_thematic_layer }¶

专题图 展示了地理分布的空间变化。它们显示了针对选定数据项（如指标或数据元素）、时间段和组织单位层级的汇总数据值。具有坐标且数据值匹配的组织单位将显示在地图上。

注意

您必须生成 DHIS2 分析表，才能获取汇总数据值。

主题图层在图层面板中以图层卡片的形式呈现。卡片中间显示一个图例，用于标明该图层上显示的数值范围。多功能按钮（三个点）包含显示或隐藏数据表、下载数据，以及通过**“作为图表打开”**在 “数据可视化”应用中以图表形式打开数据的选项。

创建一个主题层¶

要创建主题图层，请在**“添加图层”选项中选择“主题”**。这将打开 “主题图层”配置对话框。

1. 数据{ #1-data }¶

选择一个数据项。
在**聚合类型**字段中选择一个值，以确定要在地图上显示哪些数据值。默认情况下，选中的是“按数据元素”。其他选项包括：计数、平均值、求和、标准差偏差、方差、最小值、最大值。另见聚合运算符。
仅显示已完成的事件：在聚合过程中仅包含已完成的事件。这当您希望在指标计算中排除部分事件时，此功能非常有用。适用于指标、项目指标和事件数据项。

2. 周期{ #2-period }¶

选择主题数据所对应的时间范围。

时间段显示模式：选择在地图上如何显示所选的时间段：
- 单一（默认）：将所有选定的时间段作为单一合并图层显示，其中包含汇总数据数据。仅选择一个时间段或使用起止日期时，此项为必填。
- 时间轴：以交互式时间轴的形式按时间顺序显示多个时间段。可以在地图上添加多个时间轴图层（它们将共享相同的时间段）。
- 拆分：将多个期间并排显示以便比较。最多支持12个期间（包括多周期预设），且只能与其他分割图层组合使用（它们将（它们的时间段都相同）。
选择显示模式后，请选择定义周期的方式：
- 从预设中选择：适用于所有显示模式。您可以组合一个或多个相对周期和固定周期。
  - 相对期间：选择 相对期间，然后选择 期间类型（年， 月份**等），并选择一个或多个相关时间段，例如**今年**和 **去年**或**过去12个月。分析的默认相对时间段**可以是在“系统设置”**应用中进行设置。
  - 固定期间：选择 固定期间，然后选择 期间类型（按年， 每月**等），并选择一个或多个固定时间段，例如 **2024 或 1月 2025年**和**2025年2月**。
- 设置起止日期：仅在选择“单一显示模式”时可用。指定确切的开始和结束日期。这两个日期均为含首尾日，并将体现在交付成果中。

3. 组织单位{ #3-org-units }¶

选择要包含在该层中的组织单位。您可以自由组合特定的组织单位、组织单位层级、组织单位组以及相对用户组织单位（用户组织单位、用户子单位、用户子x2单位）。当选中用户组织单位时，映射数据将根据组织单位层级中为每位用户分配的组织单位进行显示。

Tip: Levels and groups act as filters within the org units you select - combining them will show only org units at those levels or in those groups that are descendants of your selected org units.
使用关联几何体：只有当存在其他几何体时，此下拉菜单才会显示适用于您的组织单位。这通常用于显示设施的服务覆盖范围。

4. 筛选{ #4-filter }¶

点击**“添加筛选条件”**，然后选择一个可用的数据项，即可向数据集添加新的筛选条件。
- 从下拉框中选择一个数据维度。您可以减少显示的维度数量通过使用搜索框。点击名称以选择一个维度。
- 选择一个维度后，会出现一个包含维度项的下拉菜单。请勾选这些项您希望将其包含在过滤器中。
可以添加多个筛选条件。点击筛选条件右侧的垃圾桶按钮即可将其删除。

5. 风格{ #using_maps_thematic_layer_style }¶

请选择 色域图 或 气泡图。
- 色域图会根据数据值，为每个组织单位图块分配一种颜色。这就是如果数据经过标准化处理（按人均计算），则推荐采用该方法。
- 气泡图将数据值以比例圆的形式呈现。如果数据符合以下情况，请使用这种技术：未归一化（绝对数值）。圆圈位于各组织单位的中心。设置比例圆的**小半径**和**大半径**。这些圆将根据数据值在低半径和高半径之间进行缩放。半径必须在 0 到以及 50 像素。
标签：在图层上显示组织单位名称和/或数值。选择名称、名称和数值，或值。字体大小、粗细、样式和颜色也可以进行修改。
统计没有坐标的组织单位：没有地图坐标的组织单位会被统计并显示在图例的**数据质量**部分中。它们也出现在数据表中。这些组织单位可能有数据，也可能没有。
选择图例类型：
- 自动生成的颜色图例：系统会根据分类自动生成图例您选择的方法、类数和颜色标度。将**分类**设置为以下选项之一：
  - 等间隔：将数值范围划分为大小相等的区间，每个区间跨度为 (最大值 − 最小值) ÷ 分类数。
  - 人数均等：组织单位在各班级中的分布应尽可能均匀（此外（也称为分位数分类）。某些数据集无法被均匀划分，特别是当值大量重复或不同值的数量较少时。
  - 自然分段（间隔）_和_自然分段（簇）：类界是根据……，将这些值放置在数据分布中的最大间隙处。 ckmeans 算法。这两种方法以类似的方式对数据进行分组；intervals 生成连续的类区间，而 clusters 可能会在类之间留下一些没有值落入的空隙。
  - 美观的换行：断点会被四舍五入为整洁、易于人类阅读的数字。基于 R 的漂亮算法。
  - 对数刻度：采用对数刻度。数值必须为正数；零或负数这些值未被分类。
  - 标准差：各组被定义为距均值。每个区间所包含的标准差个数取决于区间的数量被选中；距离均值较远的值则未被分类。
  小数位数：图例标签中显示的小数位数。选择自动时，应用程序会根据数据范围进行决定，或从 0 到 6 之间选择一个固定值（也可选择（适用于单色图例）。
  
  孤立类：定义一个值范围（min–max），并为其指定固定颜色和可选标签。该范围内的组织单位将单独显示，且不纳入自动分类。
- 预设颜色图例：从预设图例中进行选择。
- 单色图例：选择气泡或圆圈的颜色。仅适用于气泡图。
包含未分类的组织单位：其值超出所有分类范围的组织单位范围以可配置的颜色和标签显示（默认："未分类"）。
包含无数据的组织单位：无数据值的组织单位将以可配置的格式显示颜色和标签（默认：“无数据”）。

注：所有图例项目及其计数——包括**无数据**和**未分类**——仅包含具有坐标的组织单位。

注

大多数分类采用半开区间（startValue ≤ value< endValue): a value sitting exactly on ，边界值属于上层分类，而非其标签终止处的那个分类。例外情况——即上界包含该值——包括最后一个分类、孤立分类、单值分类以及聚类（自然分界点）。

如果边界值所属的确切类别对您的分析至关重要，请使用标签将数值直接叠加在每个要素上。如果这样操作后仍存在问题，请考虑是否应采用不同的图例（例如增加类别数量或提高小数位数），以更好地满足您试图做出的决策。

点击**“添加图层”**。

修改主题层¶

在图层面板中，点击主题图层卡片上的编辑（铅笔）图标。
根据需要修改任意选项卡上的设置。
点击**“更新图层”**。

筛选主题层中的值¶

主题图层有一个**“显示/隐藏数据表”**选项，可通过主题图层卡片进行开启或关闭。

数据表显示了与主题图层相关的数据。点击列标题中的箭头按钮，可按该列排序。在各列标题下方的筛选字段中输入内容，可筛选显示的行。

“名称”筛选字段是查找单个组织单位的有效方法。

对于数值列，您可以使用比较运算符进行筛选：>、<, > 和 <=. Use , for OR logic and & for AND logic — for example: 2,>3&<8 匹配值 2 或任何大于 3 且小于 8 的值。

注意

数据表筛选条件是临时性的，不会随地图一起保存。

打开组织单位配置文件{ #open-org-unit-profile }¶

您可以通过以下三种方式打开组织单位配置文件：

在地图上点击一个组织单位，然后在弹出窗口中点击**查看简介**按钮。
在地图上右键单击其中一个组织单位，然后从菜单中选择**查看简介**。
在**数据表**中单击一个组织单位行。

在组织单位层级之间导航{ #navigate-between-org-unit-hierarchies }¶

当地图上显示有组织单位时，您可以轻松地在层级结构中向上或向下导航，而无需更改所选的组织单位。

右键单击其中一个组织单位。
选择**向上钻取一级**或**向下钻取一级**。

如果您处于最低级别，或者没有坐标，则“钻取”选项将被禁用可在下级层级中使用。同样，从最高层级开始，“向上钻取”选项将被禁用。

删除主题图层{ #remove-a-thematic-layer }¶

要从地图中移除一个主题图层，请在左侧的图层卡片中，点击“更多操作” （三个点）图标，然后点击**移除图层**。

管理事件层¶

事件图层显示DHIS2项目中记录的事件的地理位置。在主题图层中，您可以可视化汇总到组织单位层级的事件数据；而在事件图层中，您可以显示具有独立点或多边形坐标的单个事件或病例。通过其他坐标字段，您还可以使用事件本身以外的位置信息来绘制事件，例如组织单位或登记地点。

若要在组织单位层面显示汇总事件统计数据，请改用包含事件数据项的主题图层。

事件图层在图层面板中以图层卡片的形式显示。卡片中间显示一个图例，用于说明该图层的样式。更多操作（三个点）按钮包含以下选项：显示或隐藏数据表，以及以 GeoJSON 格式下载数据。