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

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

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

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

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

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

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

שיתוף חסימה

1. ציון תג סגירה

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

2. מבנה הסגירה

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

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

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

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

לגבי סגירות בכבישים דו-סטריים:

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

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

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

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

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

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

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

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

  למפרטים מפורטים יותר של התגים 'מפרט פיד אירועים' ו'סגירה' (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>2016-04-07T09:00:00+01:00</starttime>
      <endtime>2016-04-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": "2016-04-07T09:00:00+01:00",
          "endtime": "2016-04-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>2017-07-04T13:31:17-04:00</creationtime>
        <updatetime>2017-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>2017-06-05T00:01:00-04:00</starttime>
        <endtime>2017-11-22T15:30:00-05:00</endtime>
      </incident>
      <incident id="zxf3kvmrpf">
        <creationtime>2017-08-04T13:31:30-04:00</creationtime>
        <updatetime>2017-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>2017-04-18T00:01:00-04:00</starttime>
        <endtime>2017-12-31T23:59:00-05:00</endtime>
      </incident>
  </incidents>

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

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

  {
    "incidents": [
      {
        "id": "3f4r45ff233",
        "creationtime": "2017-07-04T13:31:17-04:00",
        "updatetime": "2017-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": "2017-06-05T00:01:00-04:00",
        "endtime": "2017-11-22T15:30:00-05:00",
        "type": "ROAD_CLOSED"
      },
      {
        "id": "zxf3kvmrpf",
        "creationtime": "2017-08-04T13:31:30-04:00",
        "updatetime": "2017-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": "2017-04-18T00:01:00-04:00",
        "endtime": "2017-12-31T23:59:00-05:00"
      }
    ]
  }