CIFS 規格
CIFS (閉包與事件動態饋給規格) 是 Waze 的標準通訊協定，用於說明合作夥伴動態饋給中的事件和道路封閉情形。
下方的參數表格會將每個元素分類，如下所示：
- 必要：如果必要標記缺少格式正確的值，系統就會將動態饋給視為無效。
- 已要求：雖然技術上並非必要，但建議使用請求的代碼。
- 選用：這是選用標記，可用來提供更多資料。
元素的順序不會影響用來剖析檔案的引擎。
這些標記可以根據 type 標記的值來描述事件或道路封閉情形。依照關聯性說明細微差異。
以下列出一些動態饋給中的道路封閉情形示例
以下列舉幾個動態饋給中的事件
請注意，你可以在同一個動態饋給檔案中混合使用閉包和事故。
CIFS 元素
| 元素 | 必要 | 代碼輸入 | 說明 |
|---|---|---|---|
| 事件 ID | 必要 | 任意文字 | 指定英數字元 ID。
<incident id="LND11DEayKr">...</incident> |
| 類型 | 必要 | 下列其中一個值：
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
類型將決定 Waze 應用程式使用事件的方式。
所有其他類型都會顯示在 Waze 地圖上，並會在附近 Wazers 時觸發彈出式通知，但不會直接影響路線。 <type>ROAD_CLOSED</type> |
| 子類型 | 已要求 | 查看允許的子類型清單 | 針對遭檢舉事件類型提供更精確的說明。
|
| 折線 | 必要 | 空白的 lat lon 組合清單 |
十進位度數 (DD，投影 SRID 4326) 經緯度座標，用於說明事件或道路封閉的位置。在理想情況下，這些參數的小數點後應至少包含 6 位數，才能取得足夠的準確性。 座標的順序必須反映受影響的車流量方向。 我們無法從單一點擷取車流量方向。 以下折線將影響一個車流方向 (加入 <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 |
指定一段服務中斷期間的開始日期。您可以針對非 ROAD_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> |
| description | 已要求 | 任意文字 | 流量中斷的原因。這則說明的長度必須少於 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 |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|