מפרט CIFS

‫CIFS (Closure and Incident Feed Specification) הוא הפרוטוקול הסטנדרטי של 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>
רחוב חובה טקסט חופשי

מציין את שם הרחוב או הכביש שבו מתרחש האירוע.

<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