CIFS 规范

CIFS（关闭和事故 Feed 规范）是 Waze 的标准协议，用于描述合作伙伴的Feed。

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

  • 必需：如果必需标记缺少格式正确的值，您的 Feed 会被视为无效。
  • 已请求：虽然从技术上来讲并非必需，但已被视为建议添加的代码。
  • 可选：可让您提供更多数据的可选标记。

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

这些标记可以根据 type 标记的值描述事故或道路封闭情况。 并视情况对细微差异加以说明。

下面是一些 Feed 中的道路封闭示例
下面是一些 Feed 中的突发事件示例
请注意，您可以在同一 Feed 文件中混合使用“封闭”和“突发事件”。

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>
开始时间 必填 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>
说明 已请求 自由文本

导致流量中断的原因。此广告内容描述应少于 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 
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