Menggunakan data lokasi dalam solusi Azure IoT Central

Artikel
03/04/2024

Artikel ini menunjukkan cara menggunakan data lokasi di aplikasi IoT Central. Perangkat yang terhubung ke IoT Central dapat mengirim data lokasi sebagai aliran telemetri atau menggunakan properti perangkat untuk melaporkan data lokasi.

Anda bisa menggunakan data lokasi untuk:

Memplot lokasi yang dilaporkan pada peta.
Plot riwayat lokasi telemetri di peta.
Membuat aturan pembatasan wilayah untuk memberi tahu operator saat perangkat masuk atau meninggalkan area tertentu.

Menambahkan kapabilitas lokasi ke templat perangkat

Cuplikan layar berikut ini menunjukkan templat perangkat dengan contoh properti perangkat dan jenis telemetri yang menggunakan data lokasi. Definisi menggunakan jenis semantik lokasi dan jenis skema geolokasi:

Sebagai referensi, definisi Digital Twins Definition Language (DTDL) v2 untuk kemampuan ini terlihat seperti cuplikan berikut:

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

Catatan

Jenis skema geopoint bukan bagian dari spesifikasi DTDL. IoT Central saat ini mendukung jenis skema geopoint dan jenis semantik lokasi untuk kompatibilitas mundur, lihat ekstensi IoT Central.

Mengirim data lokasi dari perangkat

Saat perangkat mengirim data untuk properti DeviceLocation yang diperlihatkan di bagian sebelumnya, payload terlihat seperti cuplikan JSON berikut:

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

Saat perangkat mengirim data untuk telemetri Tracking yang diperlihatkan di bagian sebelumnya, payload terlihat seperti cuplikan JSON berikut:

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

Tampilkan lokasi perangkat

Anda dapat menampilkan data lokasi di beberapa tempat di aplikasi IoT Central Anda. Misalnya, pada tampilan yang terkait dengan perangkat individual atau di dasbor.

Saat membuat tampilan untuk perangkat, Anda dapat memilih untuk memplot lokasi di peta, atau menunjukkan nilai individual:

Anda dapat menambahkan petak ke dasbor untuk memplot lokasi satu atau beberapa perangkat. Saat Anda menambahkan petak peta untuk menampilkan telemetri lokasi, Anda dapat memplot lokasi selama periode waktu tertentu, seperti yang ditunjukkan pada cuplikan layar sebelumnya.

Membuat aturan pembatasan wilayah

Anda dapat menggunakan telemetri lokasi untuk membuat aturan pembatasan wilayah yang menghasilkan peringatan saat perangkat bergerak masuk atau keluar dari area persegi panjang. Cuplikan layar berikut menunjukkan aturan yang menggunakan empat kondisi untuk menentukan area persegi panjang menggunakan nilai lintang dan bujur. Aturan akan mengirimkan email saat perangkat bergerak masuk ke area persegi panjang:

Langkah berikutnya

Sekarang setelah Anda mempelajari cara menggunakan properti di aplikasi Azure IoT Central Anda, lihat:

Bagikan melalui