مواصفات CIFS

CIFS (مواصفات خلاصة الحوادث والإغلاق) هو البروتوكول العادي الذي يتّبعه Waze لوصف الحوادث وإغلاق الطرق في الشركاء. الخلاصات.

يصنِّف جدول المَعلمات أدناه كل عنصر على النحو التالي:

  • مطلوب: في حال عدم توفّر قيمة منسّقة بشكلٍ صحيح لعلامة مطلوبة، ستُعتبر خلاصتك غير صالحة.
  • مطلوبة: على الرغم من أنّ العلامات المطلوبة غير مطلوبة من الناحية الفنية، تُعتبر العلامات المطلوبة مقترَحة.
  • اختياري: علامات اختيارية تتيح لك تقديم المزيد من البيانات.

لا يهم ترتيب العناصر بالنسبة إلى المحرك الذي يحلل الملف.

ويمكن أن تصف هذه العلامات إمّا "حادثة" أو "إغلاق طريق" وفقًا لقيمة العلامة type. يتم توضيح الاختلافات الطفيفة عندما يكون ذلك مناسبًا.

في ما يلي بعض الأمثلة على حالات إغلاق الطرق في خلاصة
في ما يلي بعض الأمثلة على الحوادث في الخلاصة.
لا تنسَ أنه يمكنك الجمع بين "حالات الإغلاق" و"الحوادث" في ملف الخلاصة نفسه.

عناصر CIFS

العنصر مطلوب إدخال العلامة الوصف
رقم تعريف الحادث مطلوب حقل التعبئة النصّية الحرّة

تحدّد هذا الحقل معرّفًا أبجديًا رقميًا أو رقميًا.
يجب أن يكون رقم التعريف فريدًا داخل خلاصتك وأن يظل ثابتًا طوال فترة الحادث.

<incident id="LND11DEayKr">...</incident>
كتابة مطلوب أحد الخيارات التالية:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM

سيحدِّد نوع الحدث الطريقة التي سيستخدم بها تطبيق Waze بيانات الحدث. سيؤدي استخدام
ROAD_CLOSED إلى الإغلاق الكامل.

كل الأنواع الأخرى ستظهر في خريطة Waze وستظهر إشعار منبثق لمستخدمي Waze القريبين، ولكن ليس لها تأثير مباشر على التوجيه.

<type>ROAD_CLOSED</type>
النوع الفرعي تاريخ الطلب الاطّلاع على قائمة الأنواع الفرعية المسموح بها

وصف أكثر دقة لنوع الحادث الذي تم الإبلاغ عنه
يجب أن يتطابق النوع الفرعي مع القيمة المقدَّمة في علامة النوع.
في ما يلي القائمة الكاملة للأنواع الفرعية المسموح بها لكل نوع

خطوط متعدّدة مطلوب قائمة بأزواج
lat lon فارغة ومفصولة

الدرجات العشرية (DD، إسقاط SRID 4326)، إحداثيات خطوط الطول والعرض التي تصف موقع الحادث أو إغلاق الطريق. ومن المفترض أن يتألّف من 6 أرقام على الأقل بعد الفاصلة العشرية للتأكد من دقة كافية.

يجب أن يعكس ترتيب الإحداثيات اتجاه حركة المرور المتأثرة.

لا يمكننا خصم اتجاه حركة المرور من نقطة واحدة.
إذا كانت العرقلة تؤثر في اتجاه واحد فقط لحركة المرور، يجب توفير إحداثيات إضافية لتوضيح الاتجاه.

سيؤثر الخط المتعدد التالي في اتجاه واحد لحركة المرور (أضِف عنصر direction للتأثير في كلا الاتجاهين):

<polyline>51.510090 -0.006902 51.509142 -0.006564
51.506291 -0.003640 51.503796 0.001051 
51.499218 0.001687 51.497365 0.002020</polyline>
اتجاه تاريخ الطلب BOTH_DIRECTIONS أو ONE_DIRECTION

لتحديد ما إذا كان التعطل أو الإغلاق يؤثر في أحد اتجاهات المرور أو كليهما على الطريق.

يوصى بشدة بتقديم اتجاه، حتى عند توفير الخطوط المتعددة. إذا كان يمكن توفير مجموعة واحدة فقط من الإحداثيات، يكون حقل الاتجاه مطلوبًا لضمان عرض الحدث في اتجاه القيادة الصحيح.

<direction>BOTH_DIRECTIONS</direction>
شارع مطلوب حقل التعبئة النصّية الحرّة

تحدّد هذه السمة اسم الشارع أو الطريق الذي يقع فيه الحدث.

<street>NW 12th St</street>
وقت البدء مطلوب yyyy-MM-dd'T'HH:mm:ss+HH:mm

تحدّد هذه السمة تاريخ البدء لفترة واحدة من الأعطال. يمكنك حذف بالنسبة إلى الحوادث من النوع ROAD_CLOSED وسنفترض أن الحادثة نشطة حاليًا.

يجب أن يكون الطابع الزمني بتنسيق ISO8601 بدقة بالثواني، وأن يتضمّن معادلة المنطقة الزمنية.

<starttime>2023-04-07T09:00:00+01:00</starttime>
وقت الانتهاء تاريخ الطلب yyyy-MM-dd'T'HH:mm:ss+HH:mm

حدد تاريخ الانتهاء باستخدام تنسيق ISO8601 بدقة بالثواني تضمين معادلة المنطقة الزمنية

إذا لم تستخدم هذه السمة، سيتم ضبط القيمة تلقائيًا على 14 يومًا بعد وقت البدء.

<endtime>2023-04-07T23:00:00+01:00</endtime>
الوصف تاريخ الطلب حقل التعبئة النصّية الحرّة

سبب تعطُّل حركة المرور. يجب أن يكون هذا الوصف أقل من 40 الأحرف. سيتم وصف الوصف الذي يزيد عن 40 حرفًا ولكن قد لا تظهر بشكل صحيح في تطبيق Waze.

<description>I-95 All NB lanes closed
btwn Exits 184 and 186.</description>
أثر الممر اختياري معلومات عن أثر الممرات المُنظَّمة يُرجى توفير هذه المعلومات فقط إذا لم ينتج عن الحادث إغلاق كامل للطريق.

اعرض معلومات عن جميع الممرات عن طريق تحديد صفيف من الممرات، باستخدام تنسيق ممرات WZDx أو تنسيق مشابه.
يمكن توفير تأثير الممرات بتنسيقين - جزئي وكامل.

مثال على التنسيق الكامل:

<lanes>
  <lane>
    <order>1</order>
    <type>LANE</type>
    <status>CLOSED</status>
  </lane>
  <lane>
    <order>2</order>
    <type>LANE</type>
    <status>OPEN</status>
  </lane>
</lanes>

مثال على التنسيق الجزئي:
<lane_impact>
  <total_closed_lanes>2</total_closed_lanes>
  <roadside>RIGHT</roadside>
</lane_impact>

الجدول الزمني اختياري <dayname>hh:mm-hh:mm</dayname>

يتم تضمين جميع أوقات البدء والانتهاء للعرقلة.

<schedule>
  <monday>09:00-11:00,17:00-21:00</monday>
  <thursday>09:00-11:00,17:00-21:00</thursday>
  <friday>09:00-11:00,17:00-21:00</friday>
  <saturday>00:00-05:00</saturday>
  <sunday>09:00-18:00</sunday>
</schedule>

الأنواع الفرعية للحوادث والإغلاق

قدِّم مزيدًا من التفاصيل حول طبيعة الحادث. مقبول يتم تحديد الأنواع الفرعية حسب النوع المقدم.

النوع الأنواع الفرعية المحتملة
ACCIDENT 
ACCIDENT_MINOR
ACCIDENT_MAJOR
HAZARD 
HAZARD_ON_ROAD
HAZARD_ON_ROAD_CAR_STOPPED
HAZARD_ON_ROAD_CONSTRUCTION
HAZARD_ON_ROAD_EMERGENCY_VEHICLE
HAZARD_ON_ROAD_ICE
HAZARD_ON_ROAD_LANE_CLOSED
HAZARD_ON_ROAD_OBJECT
HAZARD_ON_ROAD_OIL
HAZARD_ON_ROAD_POT_HOLE
HAZARD_ON_ROAD_ROAD_KILL
HAZARD_ON_ROAD_TRAFFIC_LIGHT_FAULT
HAZARD_ON_SHOULDER
HAZARD_ON_SHOULDER_ANIMALS
HAZARD_ON_SHOULDER_CAR_STOPPED
HAZARD_ON_SHOULDER_MISSING_SIGN
HAZARD_WEATHER
HAZARD_WEATHER_FLOOD
HAZARD_WEATHER_FOG
HAZARD_WEATHER_FREEZING_RAIN
HAZARD_WEATHER_HAIL
HAZARD_WEATHER_HEAT_WAVE
HAZARD_WEATHER_HEAVY_RAIN
HAZARD_WEATHER_HEAVY_SNOW
HAZARD_WEATHER_HURRICANE
HAZARD_WEATHER_MONSOON
HAZARD_WEATHER_TORNADO
ROAD_CLOSED 

ROAD_CLOSED_HAZARD
ROAD_CLOSED_CONSTRUCTION
ROAD_CLOSED_EVENT
JAM 

JAM_LIGHT_TRAFFIC
JAM_MODERATE_TRAFFIC
JAM_HEAVY_TRAFFIC
JAM_STAND_STILL_TRAFFIC
POLICE 

POLICE_VISIBLE
POLICE_HIDING