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