מפרט 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

מציין את תאריך ההתחלה של פרק זמן אחד של הפרעה. תוכל להשמיט אותה באירועים שאינם מסוג PURCHASE_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