构建合作伙伴 Feed
请完成以下流程来构建合作伙伴 Feed。
- 以 XML 或 JSON 格式创建 Feed 文件。
- 使用相关数据(例如:道路封闭、突发事件或行驶中的车辆)填充 Feed。请注意:您可以在同一 Feed 中提供关闭信息和突发事件信息。
我们建议您使用架构检查器,以确保文件格式正确且包含所有必需的参数。如需了解 Feed 元素的具体详情,请参阅XML 验证,了解文件组织和封路元素、突发事件元素或移动车辆元素。格式有误或不完整的文件将无法发布。
- 将文件发布到可使用网络浏览器访问的位置。如需查看有关此要求的说明,请参阅 Feed 文件托管。
- 如果您已加入我们的 合作伙伴中心,请登录贵组织的门户账号,然后添加链接或将文件上传到相关数据集。如果您尚未注册成为 Waze For Cities 合作伙伴,请 填写申请。必须建立合作伙伴关系,Feed 文件才能被接受并发布。
- 文件发布后,我们会验证其格式和架构是否正确。虽然我们可以进行细微修改,但如果存在更严重的缺陷,我们会将文件退回给您进行更正。如果您的 Feed 文件被退回,您必须修正该文件,然后通过直接链接将修订后的 Feed 文件上传到门户,以更新您的请求。
- 在我们的系统中实现 Feed 后,Waze 会自动提取数据,并在地图上填充相关突发事件、道路封闭和其他信息。系统每隔几分钟会自动提取一次数据,提取数据后,可能还需要几分钟时间才能在 Waze 应用中显示相应信息。如果您对 Feed 频率有特殊要求,请与 Waze 团队联系。
分享非 CIFS Feed 格式
ESRI (ArcGIS)
ArcGIS 用户可以在“道路封闭”解决方案中分享 RoadClosures_public 图层,从而设置兼容的 Feed。请按照 ESRI ArcGIS Solutions 页面上的这些说明使用 RoadClosures_public 图层。在封路图层中整理数据,然后与 Waze 分享。不支持绕行和封路图层。
Waze 需要并以以下方式使用数据:
| 封路图层字段 | Waze 字段(CIFS 元素) | 必填 | 数据消耗和要求 |
|---|---|---|---|
globalID |
支持请求 ID | 必填 | 主要唯一标识符。提供一个永久的、由系统生成的 UUID,该 UUID 在整个功能生命周期内保持不变。 |
reason + laneimpact |
类型、子类型 | 必填 | 原因和车道影响会映射到 Waze CIFS 类型/子类型。
重要提示:与“所有车道”或“部分车道”共享的 laneimpact 表示车道功能性关闭,而不是简单的道路变窄。“所有车道”表示完全封闭。其余编码值会映射到提醒。示例:
|
geometry/paths |
多段线 | 必填 | 提供描述事件或道路封闭位置的十进制度数(DD,投影 SRID 4326)纬度和经度坐标。这些值的小数点后最好至少有 6 位数,以确保足够的准确性。
坐标的顺序必须反映受影响的流量方向。 |
direction |
方向 | 已申请 | 指定中断或封闭是影响道路上的一个方向还是两个方向的交通。“单向”映射到 ONE_DIRECTION;“双向”映射到 BOTH_DIRECTIONS。 |
street |
街道 | 必填 | 指定发生突发事件的街道或道路的名称。缺少街道信息的突发事件无法注入到 Waze 中。 |
starttime |
starttime | 必填 | 指定一次中断的开始日期时间。
时间戳可以采用 Epoch 或 ISO8601 格式提供,精确到秒,并包含时区偏移量。 |
endtime |
endtime | 已申请 | 使用 Epoch 或 ISO8601 格式指定结束日期时间,精确到秒,并包含时区偏移量。
如果您省略此参数,目前系统会默认设置为开始时间后的 14 天。 |
description |
说明 | 已申请 | 流量中断的原因。此说明不得超过 40 个字符。系统会接受超过 40 个字符的说明,但该说明可能无法在 Waze 应用中正常显示。 |
activeincid |
不适用 | 可选 | 系统会跳过将 activeincid 设置为“否”的所有突发事件,并且不会将其注入到 Waze 中。 |
accessallowed |
不适用 | 可选 | 忽略。Waze 事件会影响所有司机。 |