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

אתם יכולים להשתמש בפיד השותפים של 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, משתמשים באפשרות היפוך כיוון הפעולה של Waze. Geocoding API או לבדוק בעורך המפה של 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"
    }
  ]
}