فهم نماذج عناصر Digital Twins والرسم البياني للذكاء المكاني
هام
تم إصدار إصدار جديد من خدمة Azure Digital Twins. في ضوء الإمكانات الموسعة للخدمة الجديدة، تم إيقاف خدمة Azure Digital Twins الأصلية (الموضحة في مجموعة الوثائق هذه).
لعرض وثائق الخدمة الجديدة، تفضل بزيارة وثائق Azure Digital Twins النشطة.
Azure Digital Twins هي خدمة Azure IoT تعمل على تشغيل التمثيلات الظاهرية الشاملة للبيئات المادية والأجهزة وأجهزة الاستشعار والأشخاص المرتبطة بها. فهو يحسن التطوير من خلال تنظيم المفاهيم الخاصة بالمجال في نماذج مفيدة. ثم تقع النماذج ضمن رسم بياني للذكاء المكاني. تنمذج هذه المفاهيم بأمانة العلاقات والتفاعلات بين الأشخاص والمساحات والأجهزة.
تصف نماذج عناصر Digital Twins المفاهيم والفئات والخصائص الخاصة بالمجال. يتم تعريف النماذج مسبقا من قبل المستخدمين الذين يرغبون في تخصيص الحل لاحتياجاتهم المحددة. معا، تشكل نماذج عناصر Digital Twins المعرفة مسبقا هذه علم الأورام. يصف علم بنية ذكية المناطق والأماكن والطوابق والمكاتب والمناطق وقاعات المؤتمرات وغرف التركيز. يصف علم الشبكات الشبكية للطاقة مختلف محطات الطاقة والمحطات الفرعية وموارد الطاقة والعملاء. مع نماذج عناصر Digital Twins والمخططات، يمكن تخصيص سيناريوهات واحتياجات متنوعة.
مع نماذج عناصر Digital Twins وعلم الأورام في مكانها، يمكنك ملء رسم بياني مكاني. الرسوم البيانية المكانية هي تمثيلات افتراضية للعديد من العلاقات بين المسافات والأجهزة والأشخاص ذوي الصلة بحل IoT. يوضح هذا الرسم التخطيطي مثالا على رسم بياني مكاني يستخدم علم بنية ذكية.
يجمع الرسم البياني المكاني بين المساحات والأجهزة وأجهزة الاستشعار والمستخدمين. كل منها مرتبط معا بطريقة تنمذج العالم الحقيقي. في هذه العينة، يحتوي المكان 43 على أربعة طوابق، لكل منها العديد من المناطق المختلفة. يرتبط المستخدمون بمحطات العمل الخاصة بهم ويمنحون حق الوصول إلى أجزاء من الرسم البياني. يتمتع المسؤول بحقوق إجراء تغييرات على الرسم البياني المكاني، بينما يتمتع الزائر بحقوق عرض بيانات بناء معينة فقط.
نماذج عناصر Digital Twins
تدعم نماذج عناصر Digital Twins هذه الفئات الرئيسية من الكائنات:
-
المسافات هي مواقع ظاهرية أو فعلية، على سبيل المثال،
TenantوCustomerRegion.Venue -
الأجهزة هي قطع ظاهرية أو مادية من المعدات، على سبيل المثال،
AwesomeCompany DeviceوRaspberry Pi 3. -
أجهزة الاستشعار هي كائنات تكتشف الأحداث، على سبيل المثال،
AwesomeCompany Temperature SensorوAwesomeCompany Presence Sensor. - يحدد المستخدمون الشاغلين وخصائصهم.
فئات أخرى من الكائنات هي:
- يتم إرفاق الموارد بمسافة وتمثل عادة موارد Azure لاستخدامها من قبل الكائنات في الرسم البياني المكاني، على سبيل المثال،
IoTHub. - يتم إرفاق الكائنات الثنائية كبيرة الحجم بالكائنات (مثل المسافات والأجهزة وأجهزة الاستشعار والمستخدمين). يتم استخدامها كملفات مع نوع mime وبيانات التعريف، على سبيل المثال،
mapspicturesو و.manuals -
الأنواع الموسعة هي تعدادات قابلة للتوسيع تزيد من الكيانات ذات خصائص محددة، على سبيل المثال
SpaceTypeوSpaceSubtype. - تمثل التطبيلات مجموعة من الأنواع الموسعة، على سبيل المثال،
DefaultوBACnetBuilding.EnergyGrid -
مفاتيح الخصائص والقيم هي خصائص مخصصة للمساحات والأجهزة وأجهزة الاستشعار والمستخدمين. ويمكن استخدامها مع الخصائص المضمنة، على سبيل المثال،
DeltaProcessingRefreshTimeكمفتاح وكقيمة10. -
الأدوار هي مجموعات من الأذونات المعينة للمستخدمين والأجهزة في الرسم البياني المكاني، على سبيل المثال،
Space AdministratorUser Administratorو و.Device Administrator - تعيينات الدور هي الاقتران بين دور وعنصر في الرسم البياني المكاني. على سبيل المثال، يمكن منح مستخدم أو كيان خدمة الإذن لإدارة مسافة في الرسم البياني المكاني.
- توفر مخازن مفاتيح الأمان مفاتيح الأمان لجميع الأجهزة في التسلسل الهرمي ضمن كائن مساحة معين للسماح للجهاز بالاتصال بأمان مع Digital Twins.
- تسمح الوظائف المعرفة من قبل المستخدم (UDFs) بمعالجة القياس عن بعد للمستشعر القابل للتخصيص داخل الرسم البياني المكاني. على سبيل المثال، يمكن ل UDF:
- تعيين قيمة أداة استشعار.
- تنفيذ منطق مخصص استنادا إلى قراءات المستشعر، وتعيين الإخراج إلى مسافة.
- إرفاق بيانات التعريف بمسافة.
- إرسال إعلامات عند استيفاء الشروط المحددة مسبقا. حاليا، يمكن كتابة UDFs بلغة JavaScript.
- المطابقات هي كائنات تحدد UDFs التي يتم تنفيذها لرسالة بيانات تتبع الاستخدام معينة.
-
نقاط النهاية هي المواقع التي يمكن فيها توجيه رسائل بيانات تتبع الاستخدام وأحداث Digital Twins، على سبيل المثال،
Event HubService Busو و.Event Grid
رسم بياني للذكاء المكاني
الرسم البياني المكاني هو الرسم البياني الهرمي للمسافات والأجهزة والأشخاص المحددين في نموذج كائن Digital Twins. يدعم الرسم البياني المكاني التوريث والتصفية والاجتياز وقابلية التوسع وقابلية التوسع. يمكنك إدارة الرسم البياني المكاني والتفاعل معه باستخدام مجموعة من واجهات برمجة تطبيقات REST.
إذا قمت بنشر خدمة Digital Twins في اشتراكك، فستصبح المسؤول العام للعقدة الجذر. ثم يتم منحك حق الوصول الكامل تلقائيا إلى البنية بأكملها. توفير المسافات في الرسم البياني باستخدام واجهة برمجة تطبيقات الفضاء. توفير الخدمات باستخدام واجهة برمجة تطبيقات الجهاز وأجهزة الاستشعار باستخدام واجهة برمجة تطبيقات الاستشعار. تتوفر أيضا أدوات مفتوحة المصدر لتوفير الرسم البياني بشكل مجمع.
توريث الرسم البياني. ينطبق التوريث على الأذونات والخصائص التي تنحدر من عقدة أصل إلى جميع العقد الموجودة أسفلها. على سبيل المثال، عند تعيين دور لمستخدم على عقدة معينة، يكون لدى المستخدم أذونات هذا الدور للعقدة المحددة وكل عقدة أسفلها. يتم توريث كل مفتاح خاصية ونوع موسع معرف لعقدة معينة بواسطة جميع العقد أسفل تلك العقدة.
تصفية الرسم البياني. يتم استخدام التصفية لتضييق نطاق نتائج الطلب. يمكنك التصفية حسب المعرفات والاسم والأنواع والالأنواع الفرعية والمساحة الأصل والمسافات المقترنة. يمكنك أيضا التصفية حسب أنواع بيانات المستشعر ومفاتيح الخصائص والقيم واجتيازوminLevelوmaxLevel ومعلمات عامل تصفية OData الأخرى.
اجتياز الرسم البياني. يمكنك اجتياز الرسم البياني المكاني من خلال عمقه واتساعه. للعمق، اجتاز الرسم البياني من أعلى لأسفل أو من أسفل لأعلى باستخدام المعلمات التي تعبر، minLevel، وmaxLevel. اجتياز الرسم البياني للحصول على العقد التابعة المرفقة مباشرة بمسافة أصل أو أحد توابعها للاتساع. عند الاستعلام عن كائن، يمكنك الحصول على كافة الكائنات ذات الصلة التي لها علاقات بهذا الكائن باستخدام المعلمة المضمنة لواجهات برمجة تطبيقات GET.
قابلية توسع الرسم البياني. تضمن Digital Twins قابلية توسع الرسم البياني، حتى تتمكن من التعامل مع أحمال العمل في العالم الحقيقي. يمكن استخدام Digital Twins لتمثيل قوائم كبيرة من العقارات والبنية التحتية والأجهزة وأجهزة الاستشعار وبيانات تتبع الاستخدام والمزيد.
إمكانية توسعة الرسم البياني. استخدم القابلية للتوسعة لتخصيص نماذج عناصر Digital Twins الأساسية مع أنواع ومخططات جديدة. يمكن أيضا إثراء بيانات Digital Twins الخاصة بك بخصائص وقيم قابلة للتوسعة.
واجهات برمجة تطبيقات إدارة الرسم البياني للذكاء المكاني
بعد نشر Digital Twins من مدخل Microsoft Azure، يتم إنشاء عنوان URL Swagger لواجهات برمجة تطبيقات الإدارة تلقائيا. يتم عرضه في مدخل Microsoft Azure في قسم Overview بالتنسيق التالي.
https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
| الاسم | استبدال بـ |
|---|---|
| YOUR_INSTANCE_NAME | اسم مثيل Digital Twins الخاص بك |
| YOUR_LOCATION | منطقة الخادم التي تتم استضافة المثيل عليها |
يظهر تنسيق URL الكامل في هذه الصورة.
لمزيد من التفاصيل حول كيفية استخدام الرسوم البيانية للذكاء المكاني، تفضل بزيارة معاينة التسلل إلى واجهات برمجة تطبيقات Azure Digital Twins Management.
تلميح
يتم توفير معاينة التسلل Swagger لإظهار مجموعة ميزات واجهة برمجة التطبيقات. تتم استضافته في docs.westcentralus.azuresmartspaces.net/management/swagger.
تعرف على المزيد حول كيفية استخدام Swagger.
يجب مصادقة جميع استدعاءات واجهة برمجة التطبيقات باستخدام OAuth. تتبع واجهات برمجة التطبيقات اصطلاحات Microsoft REST API Guidelines. تدعم معظم واجهات برمجة التطبيقات التي ترجع المجموعات خيارات استعلام نظام OData .
الخطوات التالية
للتعرف على اتصال الجهاز وكيفية إرسال رسائل القياس عن بعد إلى Digital Twins، اقرأ اتصال جهاز Azure Digital Twins والدخول إلى بيانات تتبع الاستخدام.
للتعرف على قيود واجهة برمجة تطبيقات الإدارة والتقييدات، اقرأ إدارة وقيود واجهة برمجة تطبيقات Azure Digital Twins.