この記事では、IoT Central アプリケーションで位置情報データを使用する方法について説明します。 IoT Central に接続されているデバイスは、位置情報データをテレメトリ ストリームとして送信したり、デバイス プロパティを使用して場所データを報告したりできます。
位置情報データを使用すると、次のことができます。
- 報告された場所をマップにプロットします。
- テレメトリの場所の履歴をマップにプロットします。
- デバイスが特定の領域に出入りしたときにオペレーターに通知するジオフェンシング ルールを作成します。
デバイス テンプレートに場所機能を追加する
次のスクリーンショットは、場所データを使用するデバイス プロパティとテレメトリの種類の例を含むデバイス テンプレートを示しています。 定義では、 場所 セマンティック型と 位置情報 スキーマ型が使用されます。
参考までに、これらの機能の Digital Twins Definition Language (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 では現在、下位互換性のために ジオポイント スキーマの種類と 場所 のセマンティック型がサポートされています。 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 アプリケーションでは、場所データを複数の場所に表示できます。 たとえば、個々のデバイスに関連付けられたビューや、ダッシュボードなどです。
デバイスのビューを作成する場合は、マップ上に場所をプロットするか、個々の値を表示するかを選択できます。
マップ タイルをダッシュボードに追加して、1 つ以上のデバイスの場所をプロットできます。 マップ タイルを追加して位置情報テレメトリを表示すると、前のスクリーンショットに示すように、一定期間にわたって場所をプロットできます。
ジオフェンシング ルールを作成する
位置情報テレメトリを使用して、デバイスが四角形の領域に移動または外に移動したときにアラートを生成するジオフェンシング ルールを作成できます。 次のスクリーンショットは、緯度と経度の値を使用して四角形領域を定義するために 4 つの条件を使用するルールを示しています。 デバイスが四角形領域に移動すると、ルールによって電子メールが生成されます。
次のステップ
Azure IoT Central アプリケーションでプロパティを使用する方法を確認したら、次を参照してください。