מידע על סגירות כבישים

אתם יכולים להשתמש בפיד השותפים של Waze כדי לספק חסימות כבישים מתוכננות וחסימות כבישים בזמן אמת באופן אוטומטי ובכמות גדולה.

החסימות המתוכננות ששולחים ל-Waze יופיעו בעורך המפה של Waze, ויופיעו באפליקציית Waze במהלך הסגירה בפועל.

יש לציין חסימות כבישים רק אם כל הנתיבים בכביש חסומים. אם החסימה משפיעה רק על חלק מהנתיבים, צריך לתאר את הנתיבים המושפעים ברכיב 'השפעה על נתיבים'.

כדי שסגירת כבישים תופיע במפה בצורה מדויקת, עליכם לפעול לפי ההנחיות הבאות ולציית למפרטי CIFS.

אם הפיד לא עומד במפרטי CIFS אבל כולל את כל הנתונים הנדרשים, יכול להיות שמערכת Waze עדיין תוכל לעבד אותו. שולחים את הפיד דרך מרכז השותפים לצורך אימות ומשוב.

אם הנתונים לא מלאים או לא תואמים, החסימות לא יופיעו במפה באופן אוטומטי, אלא יישלחו לקהילת העריכה שלנו כ'בעיה במפה' לבדיקה ידנית, לאישור או לדחייה.

שיתוף חסימה

1. ציון תג חסימה

כדי למפות חסימת כביש, מציינים את הערך ROAD_CLOSED כקלט התג של הרכיב type.

2. מבנה החסימה

כדי לשתף חסימת כביש עם Waze, צריך לציין את השדות polyline (חובה) ו-direction (בקשה).

• קווים פולינימיים הם רצפים של קואורדינטות שמתאימים לגיאומטריה של הכביש ומתארים את מקטע הכביש שצריך לסגור.
• סדר הקואורדינטות בקו הפוליגוני מאפשר לנו לדעת איזה כיוון תנועה מושפע.
• direction מציין אם החסימה רלוונטית לכיוון אחד או לשני הכיוונים של התנועה.

במקרה של סגירה בכבישים חד-סטריים:

• סדר הנקודות בקו הפוליגוני חייב להתאים לכיוון התנועה.
• כדי למנוע אי-בהירות ולעקוף הבדלים במיפוי, מומלץ לציין את הערך ONE_DIRECTION גם לגבי כבישים חד-סטריים.

במקרה של חסימות בכבישים דו-סטריים:

• אם החסימה משפיעה רק על כיוון אחד: סדר הקואורדינטות בקו הפוליגוני מראה לנו איזה כיוון תנועה צריך לחסום.
• אם החסימה משפיעה על שני הכיוונים: משתפים את קו הפוליגון, ובשדה הכיוון מציינים BOTH_DIRECTIONS.

אם מדובר בקו פוליגון שמתחיל בנקודה א' ומסתיים בנקודה ב', החסימה תשפיע על כיוון התנועה בהתאם לכיוון ולסוג הכביש, כפי שמתואר בהמשך:

3. עיצוב הקו הפוליגוני

• ככל שהקו הפוליגוני דומה יותר לגיאומטריה של הכביש, כך יש סיכוי גבוה יותר שמערכת Waze תוכל להתאים אותו בצורה נכונה ולעבד את החסימה.
  מומלץ מאוד לספק כמה נקודות לכל מקטע בין קואורדינטות ההתחלה והסיום. יכול להיות שרק 2 קואורדינטות יספיקו לקטעים קצרים או ישרים, אבל לרוב הן גורמות לכשלים בעיבוד.
  קו הפוליגון הבא שומר בצורה נכונה על הצורה הכללית של הכביש:
  

  
  הקו הפוליגוני הבא לא משקף בבירור את הגיאומטריה של הכביש כי הוא מספק רק את קואורדינטות ההתחלה והסיום:
  
  

• מערכת Waze תשתמש בקו הפוליגון שסיפקתם כדי להחיל את האירוע על מקטע אחד או יותר במפה של Waze. חשוב לזכור שהחסימה שתיושם עשויה להיות ארוכה או קצרה במעט מהקו הפוליגוני, כי מערכת Waze יכולה לסגור רק קטעים שלמים כפי שהם מוגדרים במפה של Waze.
• אם מציינים רק חלק מהקטע כחסום, כל המקטע ייסגר.
• מומלץ שהמרחק בין נקודת ההתחלה לנקודת הסיום של החסימה יהיה לפחות 30 מטרים.
• האורך של קו הפוליגון שסופק לא יכול לחרוג מ-20 ק"מ.

4. חשוב לוודא שהחסימה עומדת בהנחיות הבאות:

• שמות של רחובות
  • חסימות יכולות להשפיע רק על רחוב או כביש אחד במפה של Waze. קואורדינטות ההתחלה והסיום של החסימה חייבות לכלול את אותו שם רחוב. סגירה שדווחה וחולפת על פני שמות רחובות שונים לא תעובד, גם אם תספקו קו פוליגון מדויק.
  • מערכת Waze תנסה להתאים את שם הרחוב שציינתם לשמות של כבישים ראשיים או חלופיים במפה של Waze במיקום המדווח. התאמה מלאה או חלקית תעזור לנו לזהות במדויק איזו דרך לסגור, במיוחד כשיש כמה אפשרויות.
    • דוגמה: I-95S, ‏ I-95 Southbound ו-JFK Memorial Highway ישויכו בהצלחה לאותה דרך.
  • כדי לוודא ששמות הרחובות והכבישים שמופיעים בנכס תואמים לאלה שמופיעים במפה של Waze, אפשר להשתמש ב-Reverse Geocoding API של Waze או לבדוק את עורך המפה של Waze.
• אפשר לשלוח חסימות לפידים רק לגבי סוגי הכבישים הבאים ב-Waze:
  • כבישים מהירים
  • כבישים מהירים
  • רחובות עירוניים
  • רמפות
  • כבישים פרטיים
• אי אפשר לדווח על חסימות כבישים ברחובות להולכי רגל.
• שעת התחלה:
  • ​חובה לציין שעת התחלה של חסימת כביש.
  • אם אתם לא בטוחים מהו מועד ההתחלה, תוכלו להשתמש בחותמת הזמן של הדוח הראשוני.
  • שינויים בשעת ההתחלה:
  • חסימות פעילות: אחרי שזמן ההתחלה של החסימה חלף (כלומר, החסימה פעילה), אסור לשנות את זמן ההתחלה.
  • חסימות עתידיות: אם מדובר בחסימות שעדיין לא התחילו, אפשר לשנות את שעת ההתחלה אם צריך. עם זאת, חשוב לוודא שהשדה event_id נשאר זהה כדי לשמור על עקביות.
• שעת סיום:
  • אם לא ידוע לכם מתי הסתיים האירוע, אפשר להשאיר את השדה ריק. לחסימות ללא זמן סיום יוקצה משך זמן ברירת מחדל (כרגע שבועיים), ולאחר מכן התוקף שלהן יפוג, אלא אם תאריכו אותן באופן מפורש על ידי ציון זמן סיום חדש. אפשר לשנות את שעת הסיום אחרי פרסום האירוע, אבל מומלץ להימנע מהגדרת שעות סיום באופן דינמי על סמך השעה הנוכחית.

למפרטים מפורטים יותר של התגים של מפרט הפיד של חסימות ואירועים (CIFS), אפשר לעיין במפרט CIFS.

דוגמאות לסגירה

בדוגמאות הבאות מוצגת חסימת כביש אחת בפורמטים XML ו-JSON.

סגירה של XML

לפניכם דוגמה לפיד שמכיל חסימה אחת של כביש בפורמט XML:

<incidents>
  <incident id="101">
    <type>ROAD_CLOSED</type>
    <subtype>ROAD_CLOSED_CONSTRUCTION</subtype>
    <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>
    <street>NW 12th St</street>
    <starttime>2024-06-07T09:00:00+01:00</starttime>
    <endtime>2024-06-07T23:00:00+01:00</endtime>
    <description>Closure on I-95 NB due to construction</description>
    <direction>BOTH_DIRECTIONS</direction>
  </incident>
</incidents>

סגירה של JSON

דוגמה לקובץ פיד שמכיל חסימה אחת של כביש בפורמט JSON:

{
  "incidents": [
    {
      "incident": {
        "id": "101",
        "type": "ROAD_CLOSED",
        "subtype": "ROAD_CLOSED_CONSTRUCTION",
        "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",
        "street": "NW 12th St",
        "starttime": "2024-06-07T09:00:00+01:00",
        "endtime": "2024-06-07T23:00:00+01:00",
        "description": "Closure on I-95 NB due to construction",
        "direction": "BOTH_DIRECTIONS"
      }
    }
  ]
}

בדוגמאות הבאות מוצג קובץ פיד של חסימת כבישים שלם בפורמטים XML ו-JSON.

קובץ פיד בפורמט XML

דוגמה לקובץ מלא של פיד לגבי סגירת כבישים בפורמט XML:

<?xml version="1.0" ?>
<incidents xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/road-incidents/cifsv2.xsd">
    <incident id="3f4r45ff233">
      <creationtime>2024-07-04T13:31:17-04:00</creationtime>
      <updatetime>2024-11-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <description>Complete road closure due to road works</description>
      <street>N Liberty St</street>
      <direction>BOTH_DIRECTIONS</direction>
      <polyline>42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266</polyline>
      <starttime>2024-06-05T00:01:00-04:00</starttime>
      <endtime>2024-11-22T15:30:00-05:00</endtime>
    </incident>
    <incident id="zxf3kvmrpf">
      <creationtime>2024-08-04T13:31:30-04:00</creationtime>
      <updatetime>2024-12-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <subtype>ROAD_CLOSED_CONSTRUCTION</subtype>
      <description>PLANNED ROAD CLOSURE St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31.</description>
        <street>St John's Sideroad</street>
        <direction>BOTH_DIRECTIONS</direction>
        <polyline>44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426</polyline>
      <starttime>2024-04-18T00:01:00-04:00</starttime>
      <endtime>2024-12-31T23:59:00-05:00</endtime>
    </incident>
</incidents>

קובץ פיד בפורמט JSON

דוגמה לקובץ מלא של פיד לגבי סגירת כבישים בפורמט JSON:

{
  "incidents": [
    {
      "id": "3f4r45ff233",
      "creationtime": "2024-07-04T13:31:17-04:00",
      "updatetime": "2024-11-17T04:40:41-05:00",
      "description": "Complete road closure due to road works",
      "street": "N Liberty St",
      "direction": "BOTH_DIRECTIONS",
      "polyline": "42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266",
      "starttime": "2024-06-05T00:01:00-04:00",
      "endtime": "2024-11-22T15:30:00-05:00",
      "type": "ROAD_CLOSED"
    },
    {
      "id": "zxf3kvmrpf",
      "creationtime": "2024-08-04T13:31:30-04:00",
      "updatetime": "2024-12-17T04:40:41-05:00",
      "description": "St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31. ",
      "type": "ROAD_CLOSED",
      "subtype": "ROAD_CLOSED_CONSTRUCTION",
      "street": "St John's Sideroad",
      "direction": "BOTH_DIRECTIONS",
      "polyline": "44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426",
      "starttime": "2024-04-18T00:01:00-04:00",
      "endtime": "2024-12-31T23:59:00-05:00"
    }
  ]
}