你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 QGIS 插件处理数据集

QGIS 是一个开源地理信息系统 (GIS) 应用程序,支持查看、编辑和分析地理空间数据。

Azure Maps QGIS 插件QGIS 中用于查看和编辑数据集。 借助该插件能够使用自定义楼层选取器导航楼层,并同时对多个特征执行 CRUD 操作。 所有 QGIS 功能(如复制特征、旋转、调整大小、翻转)都可用于高级编辑。 该插件还支持对数据编辑进行错误处理。 该插件创建的日志有助于了解 API 和调试错误。

先决条件

入门

本部分介绍如何安装 QGIS 和 Azure Maps QGIS 插件,以及如何打开和查看数据集。

安装 QGIS

如果尚未安装 QGIS,请参阅下载 QGIS。 虽然可以使用最新版本,但建议使用最稳定的版本,在同一页面上选择“查找最稳定的版本?”可以找到该版本。

A screenshot showing the QGIS download page with the Looking for the most stable version link outlined in red.

安装 Azure Maps QGIS 插件

若要安装 Azure Maps QGIS 插件,请执行以下操作:

  1. 从“插件”菜单中选择“管理和安装插件”,以打开插件管理器。

  2. 在打开的对话框中,选择“Azure Maps”插件,然后选择“安装插件”:

A screenshot showing the QGIS install plugin.

有关在 QGIS 中安装插件的详细说明,请参阅 QGIS 文档中的安装新插件

安装插件后,插件工具栏上会显示 AzureMaps 符号。

A screenshot showing The Azure Maps QGIS plugin symbol on the QGIS toolbar.

在 QGIS 插件中处理数据集

Azure Maps 数据集包含描述室内地图的数据。 数据集由定义建筑物的图层组成。 每个图层都包含称为特征的条目。 每个特征都是数据集中的一行。 特征通常具有与之关联的几何图形。 每个几何图形都包含一组描述它的属性。

featureClass 是类似特征的集合。 一个建筑物具有设施和级别特征类,包括房间和家具等特征。 例如,一个建筑物具有一个设施 featureClass,其中包含设施特征。 它还具有定义建筑物级别的级别 featureClass,每个级别是一个特征,自身具有描述该级别的属性集。 另一种 featureClass 可能是家具,每件家具都描述为一个 featureClass 特征,自身具有独特属性集。

开放数据集

以下步骤介绍如何在 QGIS 中使用 Azure Maps QGIS 插件打开数据集。

  1. 选择 QGIS 工具栏上的 Azure Maps 符号以打开“Azure Maps 插件”对话框。

    A screenshot showing the toolbar in QGIS with the Azure Maps button highlighted.

  2. 从“地理位置”下拉列表中选择你的位置,例如美国或欧洲。

  3. 输入订阅密钥

  4. 若要获取与 Azure Maps 帐户关联的所有数据集 ID 的列表,请选择“列出数据集”按钮。

  5. 从“DatasetId”下拉列表中选择所需的 datasetId

  6. (可选)如果不希望日志保存到默认位置,请更改日志的保存位置。

    A screenshot showing the Azure Maps plugin dialog box.

  7. 选择“获取特征”按钮,将室内地图数据加载到 QGIS 中,加载后,地图会在“地图画布”中显示。

    A screenshot showing the QGIS product with the indoor map.

查看数据集

加载数据集后,可以查看它在“图层”面板中包含的不同特征类。 图层的顺序决定了特征在地图上的显示方式;列表中排序靠前的图层显示在顶部。

某些图层具有包含多个图层的下拉列表,后跟图层的几何图形,如下图所示:

A screenshot showing a data set in the QGIS layers section.

图层定义显示图层可以保存不同几何图形的特征时,就会发生这种情况。 由于 QGIS 仅支持每个图层一个几何图形,因此插件按可能的几何图形拆分这些图层。

注意

QGIS 不支持 geometryCollection 几何图形。

可以使用插件工具栏中的“级别”下拉列表导航到不同的楼层,该下拉列表位于下图中 Azure Maps 插件符号旁边:

A screenshot showing the level selection drop-down as it appears on the plugin toolbar.

编辑数据集

可以使用 QGIS 添加、编辑和删除数据集的特征。

提示

在 QGIS 中编辑数据集的特征时,将使用数字化工具栏,有关详细信息,请参阅数字化现有图层

添加功能

数据集添加涉及将特征添加到图层。

  1. 在“图层”面板中,选择要添加新特征的图层。

  2. 在数字化工具栏中将编辑模式切换为 on。 若要查看数字化工具栏,请导航到“视图”>“工具栏”>“数字化工具栏”。

    A screenshot showing editing mode on the digitizing toolbar.

  3. 从数字化工具栏中选择任何添加特征选项,然后进行所需的更改。

  4. 选择数字化工具栏中的“保存”按钮以保存更改

    A screenshot showing the save changes button on the digitizing toolbar.

编辑特征

数据集编辑涉及编辑特征几何图形和属性。

编辑特征几何图形

  1. 在“图层”面板中,选择包含要编辑的特征的图层。

  2. 在数字化工具栏中将编辑模式切换为 on

  3. 从数字化工具栏中选择“顶点工具”。

    A screenshot showing the Vertex Tool button on the digitizing toolbar.

  4. 完成更改后,选择数字化工具栏中的“保存”按钮。

编辑特征属性

使用属性表编辑特征属性

  1. 打开包含要编辑的特征的图层的属性表。

    A screenshot showing the attribute table.

    注意

    属性表以表格形式显示每个特征及其属性。 通过右键单击“图层”面板中的任意图层,然后选择“打开属性表”可以访问属性表。

  2. 打开编辑模式。

  3. 编辑所需的属性。

  4. 选择“保存”按钮以保存策略。

删除特征

  1. 选择要删除的特征。

  2. 从数字化工具栏中选择删除特征选项。

    A screenshot showing the delete feature option in the digitizing toolbar.

  3. 选择数字化工具栏中的“保存”按钮以保存更改。

高级编辑

若要详细了解 QGIS 中提供的高级编辑功能(例如移动、缩放、复制和旋转功能),请参阅 QGIS 文档中的高级数字化

日志

Azure Maps QGIS 插件记录与对 Azure Maps 发出的请求相关的信息。 可以在 Azure Maps 插件对话框中设置日志文件的位置。 默认情况下,日志文件存储在包含已下载插件的文件夹中。

A screenshot of the Azure Maps QGIS plugin dialog box with the logs section highlighted.

可以通过两种方式查看日志文件:

  1. QGIS。 可以通过激活日志消息面板在 QGIS 中查看日志:

    A screenshot of the Logs Message Panel.

日志包含:

  • 有关服务器请求和响应的信息。
  • 从服务器或 QGIS 收到的错误。
  • 有关加载的特征数量的统计信息

编辑的错误日志

编辑的错误日志也存储在名为“AzureMaps_ErrorLogs”的单独文件夹中。 它们包含有关发出的请求的更多详细信息,包括标头和正文,以及从服务器收到的响应。

Python 日志

从 QGIS 框架收到的任何错误都显示在“Python 日志”选项卡中。

其他信息

如果对Azure 地图有疑问,请参阅 MICROSOFT Q&A。 请务必使用“Azure Maps”标记问题。