السياج الجغرافي لبيانات GeoJSON

  • مقالة
  • قراءة خلال 2 دقائق

تسمح لك واجهات برمجة تطبيقات GET Geofence و POST Geofence خرائط Azure POST باسترداد قرب إحداثيات بالنسبة إلى سياج جغرافي أو مجموعة من الأسوار المقدمة. توضح هذه المقالة كيفية إعداد بيانات السياج الجغرافي التي يمكن استخدامها في خرائط Azure GET و POST API.

يتم تمثيل بيانات السياج الجغرافي أو مجموعة السياج الجغرافي بواسطة Feature كائن وكائن FeatureCollection بتنسيق GeoJSON ، والذي يتم تعريفه في rfc7946. بالإضافة إلى ذلك:

  • يمكن أن يكون Feature نوع كائن GeoJSON كائنا أو FeatureCollection كائنا.
  • يمكن أن يكون نوع كائن الهندسة ، ، ، ، PointMultiPointPolygon، MultiLineStringLineStringMultiPolygonو .GeometryCollection
  • يجب أن تحتوي جميع خصائص المعالم على geometryId، والذي يستخدم لتحديد السياج الجغرافي.
  • يجب أن تحتوي الميزة التي تحتوي Pointعلى ، ، MultiLineStringMultiPointLineStringعلى radius خصائص. radius يتم قياس القيمة بالأمتار ، radius وتتراوح القيمة من 1 إلى 10000.
  • لا تحتوي الميزة ذات polygon النوع الهندسي على multipolygon خاصية نصف قطرها.
  • validityTime هي خاصية اختيارية تتيح للمستخدم تعيين وقت انتهاء الصلاحية وفترة الصلاحية الزمنية لبيانات السياج الجغرافي. إذا لم يتم تحديدها، فلن تنتهي صلاحية البيانات أبدا وتكون صالحة دائما.
  • هذا expiredTime هو تاريخ ووقت انتهاء صلاحية بيانات السياج الجغرافي. إذا كانت قيمة الطلب متأخرة عن هذه القيمة userTime ، فإن بيانات السياج الجغرافي المقابلة تعتبر بيانات منتهية الصلاحية ولا يتم الاستعلام عنها. وبناء على ذلك، سيتم تضمين الشكل الهندسي لبيانات السياج الجغرافي هذه في expiredGeofenceGeometryId صفيف ضمن استجابة السياج الجغرافي.
  • هذه validityPeriod قائمة بالفترة الزمنية لصلاحية السياج الجغرافي. إذا كانت قيمة userTime الطلب تقع خارج فترة الصلاحية ، اعتبار بيانات السياج الجغرافي المقابلة غير صالحة ولن يتم الاستعلام عنها. يتم تضمين geometryId لبيانات السياج الجغرافي هذه في invalidPeriodGeofenceGeometryId صفيف ضمن استجابة السياج الجغرافي. يوضح الجدول التالي خصائص عنصر validityPeriod.
الاسم النوع مطلوب الوصف
startTime التاريخ والوقت صواب وقت تاريخ البدء للفترة الزمنية للصلاحية.
endTime التاريخ والوقت صواب وقت تاريخ انتهاء فترة الصلاحية.
نوع التكرار سلسلة false نوع تكرار الفترة. يمكن أن تكون Dailyالقيمة ، ، ، WeeklyMonthlyأو Yearly. القيمة الافتراضية هي ⁧Daily⁩.
بيزنس داي أونلي منطقي false حدد ما إذا كانت البيانات صالحة فقط خلال أيام العمل. القيمة الافتراضية هي ⁧false⁩.
  • يتم تمثيل جميع قيم الإحداثيات على أنها [خط طول وخط عرض] محددة في WGS84.
  • لكل ميزة، والتي تحتوي على، ، ، أو ، MultiLineStringMultiPolygonGeometryCollectionيتم تطبيق الخصائص على MultiPointكافة العناصر. على سبيل المثال: ستستخدم جميع النقاط الموجودة نفس 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
                }
            ]
        }
    }
}