CIFS 規格

CIFS (封閉和事件動態饋給規格) 是 Waze 的標準通訊協定，用於描述合作夥伴動態饋給中的事件和道路封閉情形。

下方的參數表會將每個元素分類如下：

  • 必要：如果必要標記的值格式不正確，系統會將動態饋給視為無效。
  • 要求：雖然技術上並非必要，但建議您使用要求標記。
  • 選用：選用標記，可提供更多資料。

引擎剖析檔案時，元素的順序並不重要。

根據 type 標記的值，這些標記可說明事件或道路封閉情形。 如有細微差異，我們會視情況說明。

以下是動態消息中的道路封閉範例：
以下是動態消息中的事故範例：
請注意，您可以在同一個動態消息檔案中混合使用封閉和事故。

CIFS 元素

元素 必填 輸入標記 說明
事件 ID 必填 任意文字

指定英數字元或數字 ID。
ID 在動態饋給中不得重複，且在事件生命週期內保持不變。

<incident id="LND11DEayKr">...</incident>
類型 必填 以下其中一個欄位名稱：
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM

類型會決定 Waze 應用程式使用活動的方式。
ROAD_CLOSED 會導致全面封閉。

其他類型的警報會顯示在 Waze 地圖上，並觸發附近 Wazer 的彈出式通知，但不會直接影響路線。

<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>
方向 已要求 BOTH_DIRECTIONS 或 ONE_DIRECTION

指定中斷或封閉情形影響道路的一個或兩個行車方向。

強烈建議提供方向，即使已提供折線也一樣。如果只能提供一組座標，則必須填寫方向欄位，確保系統以正確的行車方向顯示活動。

<direction>BOTH_DIRECTIONS</direction>
街道 必填 任意文字

指定發生事件的街道或道路名稱。

<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>
endtime 已要求 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 車道格式或類似格式，指定車道陣列，提供所有車道的資訊。
車道影響可提供完整和部分兩種格式。

完整格式範例：
<order>1</order> 代表最左側的車道。

<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
POLICE_WITH_MOBILE_CAMERA