بيانات GeoJSON الخاص بالمحيط الجغرافي
تسمح لك خرائط Azure GET Geofence وPOST Geofence API باسترداد تقارب إحداثيات نسبة إلى المحيط الجغرافي الظاهري المتوفر أو مجموعة من الأسوار. هذه المقالة توضح بالتفصيل كيفية إعداد بيانات المحيط الجغرافي التي يمكن استخدامها في واجهة برمجة تطبيقات خرائط Azure GET وPOST.
يتم تعريف بيانات المحيط الجغرافي الظاهري أو مجموعة من المحيط الجغرافي الظاهري، ممثلة Feature
في الكائن والعنصر FeatureCollection
بالتنسيق GeoJSON
، في rfc7946. بالإضافة إلى ذلك:
- يمكن أن يكون نوع كائن GeoJSON كائن
Feature
أو كائنFeatureCollection
. - يمكن أن يكون نوع العنصر الهندسي و
Point
وMultiPoint
وLineString
وMultiLineString
وPolygon
MultiPolygon
وGeometryCollection
. - جميع خصائص الميزة يجب أن تحتوي على
geometryId
، والذي يستخدم لتحديد المحيط الجغرافي. - الميزة ذات
Point
باستخدامMultiPoint
،LineString
،MultiLineString
، يجب أن تحتوي علىradius
بالخصائص.radius
يتم قياس القيمة بالمتر،radius
تتراوح القيمة من 1 إلى 10000. - لا تحتوي الميزة ذات
polygon
النوع الهندسي علىmultipolygon
خاصية نصف قطر. validityTime
هي خاصية اختيارية تتيح للمستخدم تعيين الوقت منتهية الصلاحية وفترة الصلاحية لبيانات المحيط الجغرافي. إذا لم يتم تحديدها، فلن تنتهي صلاحية البيانات أبدًا وتكون صالحة دائمًا.expiredTime
هو تاريخ انتهاء الصلاحية ووقت بيانات المحيط الجغرافي. إذا كانت قيمةuserTime
في الطلب أحدث من هذه القيمة، فإن بيانات المحيط الجغرافي الظاهري المقابلة تعتبر بيانات منتهية الصلاحية ولا يتم الاستعلام عنها. على أساسه، يتم تضمين المعرف الهندسي لبيانات المحيط الجغرافي الظاهري هذه فيexpiredGeofenceGeometryId
الصفيف داخل استجابة المحيط الجغرافي الظاهري.validityPeriod
هي قائمة بفترة صلاحية المحيط الجغرافي. إذا كانت قيمةuserTime
في الطلب تقع خارج فترة الصلاحية، فإن بيانات المحيط الجغرافي الظاهري المقابلة تعتبر غير صالحة ولا يتم الاستعلام عن ذلك. يتم تضمين المعرف الهندسي لبيانات المحيط الجغرافي هذه في صفيفinvalidPeriodGeofenceGeometryId
ضمن استجابة المحيط الجغرافي. الجدول التالي يعرض خصائص عنصر validityPeriod.
Name | نوع | مطلوبة | الوصف |
---|---|---|---|
startTime | التاريخ/الوقت | صحيح | وقت تاريخ بدء الفترة الزمنية للصلاحية. |
endTime | التاريخ/الوقت | صحيح | وقت تاريخ انتهاء الفترة الزمنية للصلاحية. |
recurrenceType | سلسلة | true | نوع التكرار للفترة. يمكن أن تكون القيمة Daily أو Weekly أو Monthly أو Yearly . القيمة الافتراضية هي Daily . |
businessDayOnly | Boolean | true | الإشارة إلى ما إذا كانت البيانات صالحة فقط خلال أيام العمل. القيمة الافتراضية هي false . |
- يتم تمثيل كافة قيم الإحداثيات مثل [خط الطول، خط العرض] المحدد في
WGS84
. - لكل ميزة، والتي تحتوي على
MultiPoint
أوMultiLineString
أوMultiPolygon
أوGeometryCollection
، يتم تطبيق الخصائص على جميع العناصر. على سبيل المثال: تستخدم جميع النقاط فيMultiPoint
نصف القطر نفسه لتشكيل المحيط الجغرافي الظاهري لدائرة متعددة. - في سيناريو الدائرة الفاصلة، يمكن تمثيل هندسة الدائرة باستخدام كائن هندسي
Point
مع خصائص مفصلة في توسيع هندسة GeoJSON.
فيما يلي نموذج نص طلب لمحيط جغرافي ظاهري يتم تمثيله على هيئة هندسة محيط جغرافي لدائرة في GeoJSON
باستخدام نقطة مركزية ونصف قطر. تبدأ الفترة الصالحة لبيانات المحيط الجغرافي الظاهري من ، من 2018-10-22
9 صباحا إلى 5 مساء، وتتكرر كل يوم باستثناء عطلة نهاية الأسبوع. expiredTime
يشير إلى أن بيانات المحيط الجغرافي الظاهري هذه تعتبر منتهية الصلاحية، إذا كان userTime
في الطلب أحدث من 2019-01-01
.
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [-122.126986, 47.639754]
},
"properties": {
"geometryId" : "1",
"subType": "Circle",
"radius": 500,
"validityTime":
{
"expiredTime": "2019-01-01T00:00:00",
"validityPeriod": [
{
"startTime": "2018-10-22T09:00:00",
"endTime": "2018-10-22T17:00:00",
"recurrenceType": "Daily",
"recurrenceFrequency": 1,
"businessDayOnly": true
}
]
}
}
}