مواصفات 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>
direction تاريخ الطلب ‫BOTH_DIRECTIONS أو ONE_DIRECTION

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

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

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

يحدّد اسم الشارع أو الطريق الذي يقع عليه الحدث. يجب أن يتطابق مع خريطة Waze.

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

تحدّد هذه السياسة تاريخ البدء لفترة واحدة من انقطاع الخدمة. يمكنك حذف هذا الإجراء في حالات الحوادث التي ليست من النوع ROUND_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