Memahami model objek Digital Twins dan grafik kecerdasan spasial

Penting

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

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

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 kemudian terletak 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 gedung pintar menjelaskan wilayah, tempat, lantai, kantor, zona, ruang konferensi, dan ruang fokus. Ontologi jaringan energi menggambarkan berbagai pembangkit listrik, garasi, sumber daya energi, dan pelanggan. Dengan model objek dan ontologi Digital Twins, beragam skenario dan kebutuhan dapat disesuaikan.

Dengan model objek Digital Twins dan ontologi di tempat, Anda dapat mengisi grafik spasial. Grafik spasial adalah representasi virtual dari banyak hubungan antara spasi, perangkat, dan 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 ditautkan bersama-sama dengan cara yang memodelkan dunia nyata. Dalam sampel ini, tempat 43 memiliki empat lantai, masing-masing dengan banyak area yang berbeda. 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:

• Spasi adalah lokasi virtual atau fisik, misalnya, , Tenant, CustomerRegion, 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 untuk digunakan oleh objek dalam grafik spasial, misalnya, IoTHub.
• Blob dilampirkan ke objek (seperti spasi, perangkat, sensor, dan pengguna). Mereka digunakan sebagai file dengan jenis mime dan metadata, misalnya, , mapspictures, dan manuals.
• Jenis yang diperluas adalah enumerasi yang dapat diperluas yang menambah entitas dengan karakteristik tertentu, misalnya SpaceType dan SpaceSubtype.
• Ontologi mewakili sekumpulan jenis yang diperluas, misalnya, , Default, BuildingBACnet, dan EnergyGrid.
• Kunci dan nilai properti adalah karakteristik kustom ruang, perangkat, sensor, dan pengguna. 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:
  • Atur nilai sensor.
  • Lakukan logika kustom berdasarkan pembacaan sensor, dan atur output ke spasi.
  • Lampirkan metadata ke spasi.
  • Kirim pemberitahuan saat kondisi yang telah ditentukan terpenuhi. Saat ini, UDF dapat ditulis dalam JavaScript.
• Pencocok adalah objek yang menentukan UDF mana yang dijalankan untuk pesan telemetri tertentu.
• Titik akhir adalah lokasi di mana pesan telemetri dan peristiwa Digital Twins dapat dirutekan, misalnya, Event Hub, Service 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 simpul akar. Anda kemudian secara otomatis diberikan akses penuh ke seluruh struktur. Sediakan 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 memprovisikan 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 diwariskan 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, melintasi, minLevel, maxLevel, dan parameter filter OData lainnya.

Grafik melintas. Anda dapat melintasi grafik spasial melalui kedalaman dan luasnya. Untuk kedalaman, melintasi grafik top-down atau bottom-up dengan menggunakan parameter melintasi, minLevel, dan maxLevel. Melintasi grafik untuk mendapatkan simpul saudara kandung yang langsung dilampirkan ke ruang induk atau salah satu keturunannya untuk luasnya. Saat Anda mengkueri objek, Anda bisa mendapatkan semua objek terkait yang memiliki hubungan dengan objek tersebut dengan menggunakan parameter yang disertakan dari 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 Azure, URL Swagger API Manajemen dibuat secara otomatis. Ini ditampilkan di portal 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
YOUR_LOCATION	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 sneak Swagger disediakan untuk menunjukkan set 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 Pedoman REST API Microsoft. 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 ingress telemetri.

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