Memahami model objek Digital Twins dan grafik kecerdasan spasial

Penting

Versi baru layanan Azure Digital Twins telah dirilis. Sehubungan dengan kemampuan layanan baru yang diperluas, layanan Azure Digital Twins asli (dijelaskan dalam kumpulan dokumentasi ini) telah dihentikan.

Untuk melihat dokumentasi untuk layanan baru, kunjungi dokumen aktif Azure Digital Twins .

Azure Digital Twins adalah layanan Azure IoT yang mendukung representasi virtual komprehensif lingkungan fisik dan perangkat, sensor, dan orang terkait. Ini meningkatkan pengembangan dengan mengatur konsep khusus domain ke dalam model yang bermanfaat. Model-model kemudian ditempatkan dalam grafik kecerdasan spasial. Konsep tersebut dengan setia memodelkan hubungan dan interaksi antara orang, ruang, dan perangkat.

Model objek Digital Twins menjelaskan konsep, kategori, dan properti khusus domain. Model telah ditentukan sebelumnya oleh pengguna yang ingin menyesuaikan solusi dengan kebutuhan spesifik mereka. Bersama-sama, model objek Digital Twins yang telah ditentukan sebelumnya ini membentuk ontologi. Ontologi bangunan pintar menjelaskan wilayah, tempat, lantai, kantor, zona, ruang konferensi, dan ruang fokus. Ontologi jaringan energi menjelaskan berbagai pembangkit listrik, substasi, sumber daya energi, dan pelanggan. Dengan model objek dan ontologi Digital Twins, berbagai skenario dan kebutuhan dapat disesuaikan.

Dengan model objek Digital Twins dan ontologi yang telah tersedia, Anda dapat mengisi grafik spasial. Grafik spasial adalah representasi virtual dari banyak hubungan antara spasi, perangkat, dan orang-orang yang relevan dengan solusi IoT. Diagram ini menunjukkan contoh grafik spasial yang menggunakan ontologi bangunan pintar.

Grafik spasial menyatukan ruang, perangkat, sensor, dan pengguna. Masing-masing dihubungkan dengan cara yang mencontoh dunia nyata. Dalam sampel ini, venue 43 memiliki empat lantai, masing-masing dengan berbagai area. Pengguna dikaitkan dengan stasiun kerja mereka dan diberi akses ke bagian grafik. Administrator memiliki hak untuk membuat perubahan pada grafik spasial, sementara pengunjung memiliki hak untuk hanya melihat data bangunan tertentu.

Model objek Digital Twins

Model objek Digital Twins mendukung kategori utama objek ini:

• Ruang adalah lokasi virtual atau fisik, misalnya, Tenant, Customer, Region, dan Venue.
• Perangkat adalah peralatan virtual atau fisik, misalnya, AwesomeCompany Device dan Raspberry Pi 3.
• Sensor adalah objek yang mendeteksi peristiwa, misalnya, AwesomeCompany Temperature Sensor dan AwesomeCompany Presence Sensor.
• Pengguna mengidentifikasi penghuni dan karakteristik mereka.

Kategori objek lainnya adalah:

• Sumber daya dilampirkan ke ruang dan biasanya mewakili sumber daya Azure yang akan digunakan oleh objek dalam grafik spasial, misalnya, IoTHub.
• Blob dilampirkan ke objek (seperti spasi, perangkat, sensor, dan pengguna). Mereka digunakan sebagai file dengan tipe MIME dan metadata, misalnya, maps, pictures, dan manuals.
• Jenis yang diperluas adalah enumerasi yang dapat ditambah yang menambahkan karakteristik tertentu pada entitas, misalnya SpaceType dan SpaceSubtype.
• Ontologi mewakili sekumpulan jenis yang diperluas, misalnya, , Default, BuildingBACnet, dan EnergyGrid.
• Kunci dan nilai properti adalah karakteristik spasi, perangkat, sensor, dan pengguna kustom. Mereka dapat digunakan bersama dengan karakteristik bawaan, misalnya, DeltaProcessingRefreshTime sebagai kunci dan 10 sebagai nilai.
• Peran adalah sekumpulan izin yang ditetapkan untuk pengguna dan perangkat dalam grafik spasial, misalnya, , Space AdministratorUser Administrator, dan Device Administrator.
• Penetapan peran adalah hubungan antara peran dan objek dalam grafik spasial. Misalnya, pengguna atau perwakilan layanan dapat diberikan izin untuk mengelola ruang dalam grafik spasial.
• Penyimpanan kunci keamanan menyediakan kunci keamanan untuk semua perangkat dalam hierarki di bawah objek ruang tertentu untuk memungkinkan perangkat berkomunikasi dengan Digital Twins dengan aman.
• Fungsi yang ditentukan pengguna (UDF) memungkinkan pemrosesan telemetri sensor yang dapat disesuaikan dalam grafik spasial. Misalnya, UDF dapat:
  • Tetapkan nilai sensor.
  • Lakukan logika kustom berdasarkan pembacaan sensor, dan atur output ke spasi.
  • Lampirkan metadata ke ruang.
  • Kirim pemberitahuan saat kondisi yang telah ditentukan terpenuhi. Saat ini, UDF dapat ditulis dalam JavaScript.
• Matcher adalah objek yang menentukan UDF mana yang dieksekusi untuk pesan telemetri tertentu.
• Titik akhir adalah lokasi di mana pesan telemetri dan peristiwa Digital Twins dapat dirutekan, misalnya, , Event HubService Bus, dan Event Grid.

Grafik kecerdasan spasial

Grafik spasial adalah grafik hierarkis ruang, perangkat, dan orang yang ditentukan dalam model objek Digital Twins. Grafik spasial mendukung pewarisan, pemfilteran, traversing, skalabilitas, dan ekstensibilitas. Anda dapat mengelola dan berinteraksi dengan grafik spasial Anda dengan kumpulan REST API.

Jika Anda menyebarkan layanan Digital Twins di langganan Anda, Anda menjadi administrator global dari simpul akar. Anda kemudian secara otomatis diberikan akses penuh ke seluruh struktur. Memprovisikan ruang dalam grafik dengan menggunakan Space API. Memprovisikan layanan dengan menggunakan API Perangkat dan sensor dengan menggunakan API Sensor. Alat sumber terbuka juga tersedia untuk menyediakan grafik secara massal.

Warisan grafik. Pewarisan berlaku untuk izin dan properti yang turun dari simpul induk ke semua simpul di bawahnya. Misalnya, ketika peran ditetapkan ke pengguna pada simpul tertentu, pengguna memiliki izin peran tersebut ke simpul yang diberikan dan setiap simpul di bawahnya. Setiap kunci properti dan jenis yang diperluas yang ditentukan untuk simpul tertentu diwarisi oleh semua simpul di bawah simpul tersebut.

Pemfilteran grafik. Pemfilteran digunakan untuk mempersempit hasil permintaan. Anda dapat memfilter menurut ID, nama, jenis, subjenis, ruang induk, dan spasi terkait. Anda juga dapat memfilter berdasarkan jenis data sensor, kunci dan nilai properti, traversal, minLevel, maxLevel, dan parameter filter OData lainnya.

Penelusuran Graf. Anda dapat melintasi grafik spasial melalui kedalaman dan luasnya. Untuk eksplorasi lebih dalam, telusuri grafik dari atas ke bawah atau dari bawah ke atas dengan menggunakan parameter traverse, minLevel, dan maxLevel. Melintasi grafik untuk mendapatkan simpul saudara kandung yang terhubung langsung dengan ruang induk atau salah satu keturunannya dalam cakupan. Saat mengkueri objek, Anda bisa mendapatkan semua objek terkait yang memiliki hubungan dengan objek tersebut dengan menggunakan parameter menyertakan API GET.

Skalabilitas grafik. Digital Twins menjamin skalabilitas grafik, sehingga dapat menangani beban kerja dunia nyata Anda. Digital Twins dapat digunakan untuk mewakili portofolio besar real estat, infrastruktur, perangkat, sensor, telemetri, dan banyak lagi.

Ekstensibilitas grafik Gunakan ekstensibilitas untuk menyesuaikan model objek Digital Twins yang mendasarinya dengan jenis dan ontologi baru. Data Digital Twins Anda juga dapat diperkaya dengan properti dan nilai yang dapat diperluas.

API Manajemen grafik kecerdasan spasial

Setelah Anda menyebarkan Digital Twins dari portal Microsoft Azure, URL Swagger api Manajemen dibuat secara otomatis. Ini ditampilkan di portal Microsoft Azure di bagian Gambaran Umum dengan format berikut.

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger

Nama	Ganti dengan
YOUR_INSTANCE_NAME	Nama instans Digital Twins Anda
LOKASI_ANDA	Wilayah server mana instans Anda dihosting

Format URL lengkap muncul dalam gambar ini.

Untuk detail selengkapnya tentang cara menggunakan grafik kecerdasan spasial, kunjungi pratinjau menyelinap API Manajemen Azure Digital Twins.

Tip

Pratinjau awal Swagger disediakan untuk menunjukkan fitur-fitur API. Ini dihosting di docs.westcentralus.azuresmartspaces.net/management/swagger.

Pelajari selengkapnya tentang cara menggunakan Swagger.

Semua panggilan API harus diautentikasi dengan menggunakan OAuth. API mengikuti konvensi Panduan Microsoft REST API. Sebagian besar API yang mengembalikan koleksi mendukung opsi kueri sistem OData .

Langkah berikutnya

• Untuk mempelajari tentang konektivitas perangkat dan cara mengirim pesan telemetri ke Digital Twins, baca Konektivitas perangkat Azure Digital Twins dan masuknya telemetri.

• Untuk mempelajari tentang batasan dan pembatasan API Manajemen, baca manajemen dan batasan API Azure Digital Twins.