在 Azure IoT Central 解決方案中使用位置數據

2025-04-30

本文說明如何在IoT Central 應用程式中使用位置數據。連線到IoT Central的裝置可以將位置數據當做遙測數據流傳送，或使用裝置屬性來報告位置數據。

您可以使用位置資料來：

在地圖上繪製報告的位置。
在地圖上繪製遙測位置歷程記錄。
建立地理柵欄規則，以在裝置進入或離開特定區域時通知作員。

將位置功能新增至裝置範本

下列螢幕快照顯示裝置範本，其中包含使用位置資料的裝置屬性和遙測類型的範例。定義會使用位置語意類型和 地理位置 架構類型：

如需參考，這些功能的數位雙胞胎定義語言（DTDL）v2 定義看起來類似下列程式碼片段：

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

備註

地理點架構類型不是 DTDL 規格的一部分。 IoT Central 目前支援 地理點 架構類型和位置語意類型，以取得回溯相容性，請參閱 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 應用程式中使用屬性，請參閱：

共用方式為