فهم نماذج كائنات التوائم الرقمية والرسم البياني للذكاء المكاني
هام
تم إصدار إصدار جديد من خدمة Azure Digital Twins. في ضوء القدرات الموسعة للخدمة الجديدة، تم إيقاف خدمة Azure Digital Twins الأصلية (الموضحة في مجموعة الوثائق هذه).
لعرض وثائق الخدمة الجديدة، قم بزيارة وثائق Azure Digital Twins النشطة.
Azure Digital Twins هي خدمة Azure IoT تعمل على تشغيل تمثيلات افتراضية شاملة للبيئات المادية والأجهزة وأجهزة الاستشعار والأشخاص المرتبطة بها. إنه يحسن التطوير من خلال تنظيم المفاهيم الخاصة بالمجال في نماذج مفيدة. ثم تقع النماذج داخل رسم بياني للذكاء المكاني. مثل هذه المفاهيم نموذج بأمانة للعلاقات والتفاعلات بين الناس والمساحات والأجهزة.
تصف نماذج كائنات Digital Twins المفاهيم والفئات والخصائص الخاصة بالمجال. يتم تحديد النماذج مسبقا من قبل المستخدمين الذين يرغبون في تخصيص الحل لاحتياجاتهم الخاصة. معا ، تشكل نماذج كائنات Digital Twins المحددة مسبقا أنطولوجيا. تصف أنطولوجيا المبنى الذكي المناطق والأماكن والطوابق والمكاتب والمناطق وغرف المؤتمرات وغرف التركيز. تصف أنطولوجيا شبكة الطاقة محطات الطاقة المختلفة والمحطات الفرعية وموارد الطاقة والعملاء. مع نماذج كائنات التوائم الرقمية والأنطولوجيات ، يمكن تخصيص سيناريوهات واحتياجات متنوعة.
باستخدام نماذج كائنات Digital Twins والأنطولوجيا في مكانها الصحيح، يمكنك ملء رسم بياني مكاني. الرسوم البيانية المكانية هي تمثيلات افتراضية للعديد من العلاقات بين المساحات والأجهزة والأشخاص ذات الصلة بحل إنترنت الأشياء. يوضح هذا الرسم البياني مثالا على رسم بياني مكاني يستخدم أنطولوجيا المبنى الذكي.
يجمع الرسم البياني المكاني بين المساحات والأجهزة وأجهزة الاستشعار والمستخدمين. يرتبط كل منها معا بطريقة تشكل العالم الحقيقي. في هذه العينة، يتكون المكان 43 من أربعة طوابق، يحتوي كل منها على العديد من المناطق المختلفة. يرتبط المستخدمون بمحطات العمل الخاصة بهم ويمنحون حق الوصول إلى أجزاء من الرسم البياني. يحق للمسؤول إجراء تغييرات على الرسم البياني المكاني، بينما يحق للزائر عرض بيانات بناء معينة فقط.
نماذج كائنات التوائم الرقمية
تدعم نماذج كائنات التوائم الرقمية هذه الفئات الرئيسية من الكائنات:
- المساحات هي مواقع افتراضية أو فعلية، على سبيل المثال، و،
Tenantو، و،RegionوCustomerVenue. - الأجهزة هي قطع افتراضية أو مادية من المعدات ، على سبيل المثال ،
AwesomeCompany DeviceوRaspberry Pi 3. - أجهزة الاستشعار هي كائنات تكتشف الأحداث ، على سبيل المثال ،
AwesomeCompany Temperature SensorوAwesomeCompany Presence Sensor. - يحدد المستخدمون الركاب وخصائصهم.
فئات أخرى من الكائنات هي:
- يتم إرفاق الموارد بمساحة وتمثل عادة موارد Azure لاستخدامها من قبل الكائنات في الرسم البياني المكاني، على سبيل المثال،
IoTHub. - يتم توصيل النقاط بالكائنات (مثل المساحات والأجهزة وأجهزة الاستشعار والمستخدمين). يتم استخدامها كملفات مع نوع mime وبيانات التعريف ، على سبيل المثال ، ، ،
mapspicturesوmanuals. - الأنواع الموسعة هي تعدادات قابلة للتوسيع تزيد من الكيانات ذات الخصائص المحددة ، على سبيل المثال
SpaceTypeوSpaceSubtype. - تمثل الأنطولوجيات مجموعة من الأنواع الموسعة، على سبيل المثال، و، و، و، و، و،
DefaultBuildingBACnetوEnergyGrid - مفاتيح الخصائص والقيم هي خصائص مخصصة للمساحات والأجهزة وأجهزة الاستشعار والمستخدمين. يمكن استخدامها جنبا إلى جنب مع الخصائص المدمجة ، على سبيل المثال ،
DeltaProcessingRefreshTimeكمفتاح وكقيمة10. - الأدوار هي مجموعات من الأذونات المعينة للمستخدمين والأجهزة في الرسم البياني المكاني، على سبيل المثال، و،
Space AdministratorUser AdministratorوDevice Administrator. - تعيينات الدور هي الارتباط بين دور وكائن في الرسم البياني المكاني. على سبيل المثال، يمكن منح مستخدم أو مدير خدمة إذنا لإدارة مساحة في الرسم البياني المكاني.
- توفر مخازن مفاتيح الأمان مفاتيح الأمان لجميع الأجهزة في التسلسل الهرمي تحت جسم فضائي معين للسماح للجهاز بالاتصال بأمان مع Digital Twins.
- تتيح الوظائف المعرفة من قبل المستخدم (UDFs) معالجة القياس عن بعد للمستشعر القابل للتخصيص داخل الرسم البياني المكاني. على سبيل المثال، يمكن ل UDF:
- تعيين قيمة مستشعر.
- قم بإجراء منطق مخصص استنادا إلى قراءات المستشعر، واضبط الإخراج على مساحة.
- إرفاق بيانات التعريف بمساحة.
- إرسال إشعارات عند استيفاء الشروط المحددة مسبقا. حاليا ، يمكن كتابة UDFs في جافا سكريبت.
- المطابقات هي كائنات تحدد UDFs التي يتم تنفيذها لرسالة قياس عن بعد معينة.
- نقاط النهاية هي المواقع التي يمكن فيها توجيه رسائل القياس عن بعد وأحداث Digital Twins ، على سبيل المثال ، ،
Event Hub،Service BusوEvent Grid.
الرسم البياني للذكاء المكاني
الرسم البياني المكاني هو الرسم البياني الهرمي للمساحات والأجهزة والأشخاص المحددين في نموذج كائن Digital Twins. يدعم الرسم البياني المكاني الميراث والتصفية والعبور وقابلية التوسع والتوسيع. يمكنك إدارة الرسم البياني المكاني والتفاعل معه باستخدام مجموعة من واجهات برمجة تطبيقات REST.
إذا قمت بنشر خدمة Digital Twins في اشتراكك، فستصبح المسؤول العمومي عن العقدة الجذرية. ثم يتم منحك تلقائيا حق الوصول الكامل إلى الهيكل بأكمله. توفير المسافات في الرسم البياني باستخدام واجهة برمجة تطبيقات الفضاء. توفير الخدمات باستخدام واجهة برمجة تطبيقات الجهاز وأجهزة الاستشعار باستخدام واجهة برمجة تطبيقات المستشعر. تتوفر أيضا أدوات مفتوحة المصدر لتوفير الرسم البياني بكميات كبيرة.
الميراث Graph. ينطبق التوريث على الأذونات والخصائص التي تنحدر من عقدة أصل إلى جميع العقد الموجودة تحتها. على سبيل المثال، عندما يتم تعيين دور لمستخدم على عقدة معينة، يكون لدى المستخدم أذونات هذا الدور للعقدة المحددة وكل عقدة تحتها. يتم توريث كل مفتاح خاصية ونوع موسع محدد لعقدة معينة بواسطة جميع العقد الموجودة أسفل تلك العقدة.
تصفية Graph. يتم استخدام التصفية لتضييق نطاق نتائج الطلب. يمكنك التصفية حسب المعرفات والاسم والأنواع والأنواع الفرعية والمساحة الأصل والمسافات المقترنة. يمكنك أيضا التصفية حسب أنواع بيانات المستشعرات ومفاتيح الخصائص والقيم والاجتيازوminLevelوmaxLevel ومعلمات مرشح OData الأخرى.
Graph العبور. يمكنك اجتياز الرسم البياني المكاني من خلال عمقه واتساعه. للحصول على العمق، اجتاز الرسم البياني من أعلى إلى أسفل أو من أسفل إلى أعلى باستخدام المعلمات التي تعبر و minLevel و maxLevel. اجتاز الرسم البياني للحصول على عقد شقيقة متصلة مباشرة بمساحة الوالدين أو أحد أحفادها من أجل الاتساع. عند الاستعلام عن كائن، يمكنك الحصول على كافة الكائنات ذات الصلة التي لها علاقات بهذا الكائن باستخدام معلمة التضمين الخاصة بواجهات برمجة تطبيقات GET.
قابلية التوسع Graph. يضمن Digital Twins قابلية توسيع الرسم البياني ، حتى يتمكن من التعامل مع أحمال العمل في العالم الحقيقي. يمكن استخدام Digital Twins لتمثيل محافظ كبيرة من العقارات والبنية التحتية والأجهزة وأجهزة الاستشعار والقياس عن بعد والمزيد.
قابلية Graph للتوسعة. استخدم قابلية التوسعة لتخصيص نماذج كائنات Digital Twins الأساسية بأنواع وأنطولوجيات جديدة. يمكن أيضا إثراء بيانات Digital Twins الخاصة بك بخصائص وقيم قابلة للتوسعة.
واجهات برمجة تطبيقات إدارة الرسم البياني للذكاء المكاني
بعد نشر Digital Twins من مدخل Azure، يتم إنشاء عنوان URL ل Swagger الخاص بواجهات برمجة تطبيقات الإدارة تلقائيا. يتم عرضه في مدخل Azure في قسم نظرة عامة بالتنسيق التالي.
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. تدعم معظم واجهات برمجة التطبيقات التي ترجع المجموعات خيارات استعلام نظام OData .
الخطوات التالية
للتعرف على اتصال الجهاز وكيفية إرسال رسائل القياس عن بعد إلى Digital Twins، اقرأ اتصال جهاز Azure Digital Twins ودخول القياس عن بعد.
للتعرف على قيود واجهة برمجة تطبيقات الإدارة والقيود المفروضة عليها، اقرأ إدارة واجهة برمجة تطبيقات Azure Digital Twins وقيودها.