CIFS 规范
CIFS（封闭和突发事件 Feed 规范）是 Waze 在合作伙伴 Feed 中描述突发事件和道路封闭的标准协议。
下面的参数表对每个元素进行了如下分类：
- 必需：如果必需标记的值的格式有误，您的 Feed 会被视为无效。
- 已请求：虽然从技术层面来讲，这并不是强制性要求，但系统会将所请求的代码视为推荐代码。
- 可选：可让您提供更多数据的可选标记。
元素的顺序对解析文件的引擎而言无关紧要。
这些标记可根据 type 标记的值描述突发事件或道路封闭。
对于细微差异，我们会在适用情况下进行说明。
下面是 Feed 中的道路封闭示例
以下是 Feed 中的突发事件示例
请注意，您可以在同一 Feed 文件中混合显示封闭路段和突发事件。
CIFS 元素
| 元素 | 必需 | 代码输入 | 说明 |
|---|---|---|---|
| 突发事件 ID | 必需 | 自由文本 | 指定字母数字或数字标识符。
<incident id="LND11DEayKr">...</incident> |
| 类型 | 必需 | 以下各项中的一项：
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
该类型将决定 Waze 应用使用事件的方式。 所有其他类型都会显示在 Waze 地图中，并且会为附近的 Waze 用户触发弹出式通知，但对路线没有直接影响。 <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> |
| 说明 | 已请求 | 自由文本 | 流量中断的原因。此说明应少于 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 |
|