مواصفات 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>
starttime مطلوب yyyy-MM-dd'T'HH:mm:ss+HH:mm

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

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

<starttime>2023-04-07T09:00:00+01:00</starttime>
endtime تاريخ الطلب 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 أو تنسيق مشابه.
يمكن تقديم معلومات عن تأثير المسار بتنسيقَين: كامل وجزئي.

مثال على التنسيق الكامل:
تمثّل<order>1</order> الحارة المرورية في أقصى اليسار.

<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
POLICE_WITH_MOBILE_CAMERA