CIFS 规范

CIFS（关闭和突发事件 Feed 规范）是 Waze 的标准协议，用于描述合作伙伴 Feed 中的突发事件和道路封闭情况。

下方的参数表按如下方式对每个元素进行了分类：

  • 必需：如果必需标记的值格式不正确，您的 Feed 将被视为无效。
  • 已请求：虽然从技术上讲不是必需的，但已请求的标记被视为建议。
  • 可选：允许您提供更多数据的可选标记。

对于解析文件的引擎而言，元素的顺序无关紧要。

这些标记可以根据 type 标记的值来描述事件或道路封闭情况。相关文档会说明细微的差异。

以下是信息流中的道路封闭示例
以下是信息流中的突发事件示例
请注意，您可以在同一信息流文件中混合使用封闭和突发事件。

CIFS 元素

元素 必需 标记输入 说明
事件 ID 必需 自由文本

指定字母数字或数字标识符。
ID 在 Feed 中必须是唯一的，并且在事件的整个生命周期内保持稳定。

<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>
starttime 必需 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