مشاركة عبر


بيانات GeoJSON الخاص بالمحيط الجغرافي

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

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

  • يمكن أن يكون نوع كائن GeoJSON كائن Feature أو كائن FeatureCollection.
  • يمكن أن يكون نوع العنصر الهندسي وPoint وMultiPoint وLineString وMultiLineString وPolygonMultiPolygon و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-229 صباحا إلى 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
                }
            ]
        }
    }
}