Bagikan melalui


Menggunakan data lokasi dalam solusi Azure IoT Central

Artikel ini memperlihatkan kepada Anda cara menggunakan data lokasi dalam 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 dapat menggunakan data lokasi untuk:

  • Tandai lokasi yang dilaporkan di peta.
  • Plot riwayat lokasi telemetri di peta.
  • Buat aturan geofencing untuk memberi tahu operator saat perangkat memasuki atau meninggalkan area tertentu.

Menambahkan kemampuan lokasi ke templat perangkat

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

Cuplikan layar memperlihatkan definisi properti lokasi dalam templat perangkat

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"
}

Nota

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 ditampilkan di bagian sebelumnya, payload terlihat seperti cuplikan JSON berikut:

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

Saat perangkat mengirim data untuk telemetri Pelacakan yang ditampilkan 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 memperlihatkan nilai individual:

Cuplikan layar memperlihatkan tampilan contoh dengan data lokasi

Anda dapat menambahkan petak peta 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 geofencing

Anda dapat menggunakan telemetri lokasi untuk membuat aturan geofencing yang menghasilkan pemberitahuan saat perangkat berpindah ke atau keluar dari area persegi panjang. Cuplikan layar berikut menunjukkan aturan yang menggunakan empat kondisi untuk menentukan area persegi panjang menggunakan nilai garis lintang dan bujur. Aturan menghasilkan email saat perangkat berpindah ke area persegi panjang:

Cuplikan layar yang memperlihatkan definisi aturan geofencing

Langkah selanjutnya

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