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

使用 Azure IoT Central 解决方案中的位置数据

项目
06/03/2024

本文介绍如何在 IoT Central 应用程序中使用位置数据。连接到 IoT Central 的设备可将位置数据作为遥测流发送，也可使用设备属性来报告位置数据。

位置数据可用于：

在地图上绘制报告的位置。
在地图上绘制遥测位置历史记录。
创建地理围栏规则，以便在设备移入/移出特定区域时通知操作员。

向设备模板添加位置功能

以下屏幕截图显示了一个设备模板，其中包含使用位置数据的设备属性和遥测类型的示例。定义使用 location 语义类型和 geolocation 架构类型：

这些功能的数字孪生定义语言 (DTDL) v2 定义如下所示，可供参考：

{
  "@type": [
    "Property",
    "Location"
  ],
  "displayName": {
    "en": "DeviceLocation"
  },
  "name": "DeviceLocation",
  "schema": "geopoint",
  "writable": false
},
{
  "@type": [
    "Telemetry",
    "Location"
  ],
  "displayName": {
    "en": "Tracking"
  },
  "name": "Tracking",
  "schema": "geopoint"
}

注意

geopoint 架构类型不属于 DTDL 规范。 IoT Central 目前支持 geopoint 架构类型和 location 语义类型，以实现后向兼容性，请参阅 IoT Central 扩展。

从设备发送位置数据

当设备发送上一部分中所示的 DeviceLocation 属性数据时，有效负载将与以下 JSON 代码片段类似：

{
  "DeviceLocation": {
    "lat": 47.64263,
    "lon": -122.13035,
    "alt": 0
  }
}

当设备发送上一部分中所示的跟踪遥测数据时，有效负载将与以下 JSON 代码片段类似：

{
  "Tracking": {
    "lat": 47.64263,
    "lon": -122.13035,
    "alt": 0
  }
}

显示设备位置

可在 IoT Central 应用程序中的多个位置显示位置数据。例如，在与单个设备或仪表板相关联的视图上。

为设备创建视图时，可选择在地图上绘制位置，或显示各个值：

你可向仪表板添加地图图块，绘制一个或多个设备的位置。添加地图图块以显示位置遥测数据时，可以绘制一段时间内的位置，如上一个屏幕截图所示。

创建地理围栏规则

你可使用位置遥测创建一个在设备移入/移出矩形区域时生成警报的地理围栏规则。以下屏幕截图显示了一个使用四个条件来定义使用经纬度值的矩形区域的规则。此规则将在设备移入矩形区域时生成一封电子邮件：

后续步骤

现在，你已了解如何使用 Azure IoT Central 应用程序中的属性，请参阅：

通过