Share via

خرائط Azure كمصدر لشبكة الأحداث

  • مقالة

توفر هذه المقالة الخصائص والمخطط لأحداث خرائط Azure. للحصول على مقدمة لمخططات الأحداث، راجع مخطط حدث Azure Event Grid. كما يوفر لك قائمة بالبدء السريع والبرامج التعليمية لاستخدام خرائط Azure كمصدر للحدث.

أنواع الأحداث المتاحة

يرسل حساب خرائط Azure أنواع الأحداث التالية:

نوع الحدث ‏‏الوصف
Microsoft.Maps.GeofenceEntered يُرفع عند انتقال الإحداثيات المستلمة من خارج السياج الجغرافي المحدد إلى الداخل
Microsoft.Maps.GeofenceExited يُرفع عند انتقال الإحداثيات المستلمة من داخل سياج جغرافي معين إلى الخارج
Microsoft.Maps.GeofenceResult تُرفع في كل مرة يقوم فيها استعلام geofencing بإرجاع نتيجة، بغض النظر عن الحالة

مثال الأحداث

يوضح المثال التالي مخطط حدث GeofenceEntered

{   
   "id":"7f8446e2-1ac7-4234-8425-303726ea3981", 
   "source":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Maps/accounts/{accountName}", 
   "subject":"/spatial/geofence/udid/{udid}/id/{eventId}", 
   "data":{   
      "geometries":[   
         {   
            "deviceId":"device_1", 
            "udId":"1a13b444-4acf-32ab-ce4e-9ca4af20b169", 
            "geometryId":"2", 
            "distance":-999.0, 
            "nearestLat":47.618786, 
            "nearestLon":-122.132151 
         } 
      ], 
      "expiredGeofenceGeometryId":[   
      ], 
      "invalidPeriodGeofenceGeometryId":[   
      ] 
   }, 
   "type":"Microsoft.Maps.GeofenceEntered", 
   "time":"2018-11-08T00:54:17.6408601Z", 
   "specversion":"1.0" 
}

يوضح المثال التالي مخطط GeofenceResult

{   
   "id":"451675de-a67d-4929-876c-5c2bf0b2c000", 
   "source":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Maps/accounts/{accountName}", 
   "subject":"/spatial/geofence/udid/{udid}/id/{eventId}", 
   "data":{   
      "geometries":[   
         {   
            "deviceId":"device_1", 
            "udId":"1a13b444-4acf-32ab-ce4e-9ca4af20b169", 
            "geometryId":"1", 
            "distance":999.0, 
            "nearestLat":47.609833, 
            "nearestLon":-122.148274 
         }, 
         {   
            "deviceId":"device_1", 
            "udId":"1a13b444-4acf-32ab-ce4e-9ca4af20b169", 
            "geometryId":"2", 
            "distance":999.0, 
            "nearestLat":47.621954, 
            "nearestLon":-122.131841 
         } 
      ], 
      "expiredGeofenceGeometryId":[   
      ], 
      "invalidPeriodGeofenceGeometryId":[   
      ] 
   }, 
   "type":"Microsoft.Maps.GeofenceResult", 
   "time":"2018-11-08T00:52:08.0954283Z", 
   "specversion":"1.0" 
}

خصائص الحدث

ويحتوي الحدث على بيانات المستوى الأعلى التالية:

الخاصية نوع الوصف
source سلسلة مسار المورد الكامل إلى مصدر الحدث. هذا الحقل غير قابل للكتابة. توفر شبكة الأحداث هذه القيمة.
subject سلسلة مسار يحدده الناشر لموضوع الحدث.
type سلسلة أحد أنواع الأحداث المسجلة لمصدر الحدث الماثل.
time سلسلة الوقت الذي يتم إنشاء الحدث استناداً إلى وقت UTC الموفر.
id سلسلة المعرف الفريد للحدث.
data كائن بيانات الحدث Geofencing.
specversion سلسلة إصدار مواصفات مخطط CloudEvents.

كائن البيانات له الخصائص التالية:

الخاصية نوع الوصف
apiCategory سلسلة فئة API للحدث.
apiName سلسلة اسم API للحدث.
issues كائن حدثت مشاكل في القوائم أثناء المعالجة. في حالة إرجاع أي مشكلات، فلن تُرجع الأشكال الهندسية مع الاستجابة.
responseCode رقم التعليمة البرمجية لاستجابة HTTP
geometries كائن يسرد الأشكال الهندسية للسياج المحتوية على موضع الإحداثيات أو تتداخل مع searchBuffer حول الموضع.

يُرجع كائن الخطأ عند حدوث خطأ في خرائط Azure API. كائن الخطأ له الخصائص التالية:

الخاصية نوع ‏‏الوصف
error تفاصيل الخطأ يُرجع هذا الكائن عند حدوث خطأ في خرائط Azure API

يُرجع كائن ErrorDetails عند حدوث خطأ في خرائط Azure API. يحتوي عنصر ErrorDetails أو ErrorDetails على الخصائص التالية:

الخاصية نوع الوصف
code سلسلة رمز حالة HTTP.
message سلسلة إذا كان ذلك متاحاً، فسيكون وصفاً يمكن قراءته من قِبل الإنسان للخطأ.
innererror خطأ داخلي عنصر يحتوي على معلومات خاصة بالخدمة حول الخطأ، إذا كان متوفراً.

InnerError هو كائن يحتوي على معلومات خاصة بالخدمة حول الخطأ. كائن InnerError له الخصائص التالية:

الخاصية نوع الوصف
code سلسلة رسالة الخطأ.

يسرد كائن الهندسة المعرف الهندسي للجيوفينس التي انتهت صلاحيتها بالنسبة إلى وقت المستخدم في الطلب. يحتوي كائن الأشكال الهندسية على عناصر هندسية بالخصائص التالية:

الخاصية نوع الوصف
deviceid سلسلة معرف الجهاز.
distance سلسلة

المسافة من إحداثيات إلى أقرب حد من السياج الجغرافي. موجب يعني أن الإحداثيات خارج السياج الجغرافي. إذا كانت الإحداثيات خارج السياج الجغرافي، ولكن أكثر من قيمة searchBuffer بعيداً عن أقرب حدود السياج الجغرافي، فإن القيمة هي 999. سالب يعني أن الإحداثيات داخل السياج الجغرافي. إذا كان الإحداثيات داخل المضلع، ولكن أكثر من قيمة searchBuffer بعيداً عن أقرب حد سياج جغرافي، فإن القيمة هي -999. تعني القيمة 999 أن هناك ثقة كبيرة في أن الإحداثيات خارج المحيط الجغرافي الظاهري. تعني قيمة -999 أن هناك ثقة كبيرة في أن الإحداثيات جيدة داخل المحيط الجغرافي الظاهري.
geometryid سلسلة المعرف الفريد يحدد هندسة السياج الجغرافي.
nearestlat رقم خط العرض لأقرب نقطة في الهندسة.
nearestlon رقم خط الطول لأقرب نقطة للهندسة.
udId سلسلة المعرف الفريد المرتجع من خدمة تحميل المستخدم عند تحميل السياج الجغرافي. لن تُضمَّن في واجهة برمجة التطبيقات (API) بعد تحديد الموقع الجغرافي.

كائن البيانات له الخصائص التالية:

الخاصية نوع ‏‏الوصف
expiredGeofenceGeometryId string[] قوائم المعرف الهندسي للسياج الجغرافي منتهي الصلاحية بالنسبة إلى وقت المستخدم في الطلب.
geometries geometries[] يسرد الأشكال الهندسية للسياج المحتوية على موضع الإحداثيات أو تتداخل مع searchBuffer حول الموضع.
invalidPeriodGeofenceGeometryId string[] قوائم المعرف الهندسي للسياج الجغرافي في فترة غير صالحة بالنسبة إلى وقت المستخدم في الطلب.
isEventPublished boolean صواب إذا تم نشر حدث واحد على الأقل لمشترك حدث خرائط Azure، يكون خطأ إذا لم يُنشر أي حدث لمشترك حدث خرائط Azure.

البرامج التعليمية والدروس المعرفية

المسمى الوظيفي ‏‏الوصف
التفاعل مع أحداث خرائط Azure باستخدام Event Grid نظرة عامة حول تكامل خرائط Azure مع شبكة الأحداث.
البرنامج التعليمي: إعداد المحيط الجغرافي الظاهري يرشدك هذا البرنامج التعليمي خلال الخطوات الأساسية لإعداد السياج الجغرافي باستخدام خرائط Azure. يمكنك استخدام Azure Event Grid لدفق نتائج السياج الجغرافي وإعداد إعلام بناءً على نتائج السياج الجغرافي.

الخطوات التالية