Feed 设置
以下信息将帮助您正确设置和运行 Feed。
Feed 文件托管
Waze 内容获取系统会自动定期提取您的 Feed 数据。为确保 Waze 检索到正确的 Feed 文件,请执行以下操作:
- 确保文件可供访问 :使用标准网络协议(HTTP、HTTPS、FTP 或 SFTP)或 Google Cloud Storage (GCS)。
- 保护您的数据(可选)
- 您可以使用 HTTPS 上的 BASIC 身份验证机制,为 Feed 加上用户名和密码。您可以通过合作伙伴中心提供登录名和密码组合。
- 此外,我们还支持 API 集成,该集成通过 KeyID 或 OCP_APIM_SUBSCRIPTION_KEY 标头利用基于标头的身份验证。
- 对于 GCS 文件,您可以限制对我们将提供的服务账号的访问权限。
- 确保可访问性 :确保托管的文件可供全球访问。
- 为避免数据提取中断,请确保您的防火墙不会根据国家/地区、IP 地址或地理区域阻止访问。这些限制可能会阻止我们检索您的 Feed 数据。
- 我们使用动态系统来提取封闭和突发事件信息。这意味着我们不使用静态 IP,也不支持预授权的网址/网域/通配符或 DNS 条目授权。
Feed 频率
内容获取系统每隔几分钟就会提取一次数据。如果您对 Feed 频率有特殊要求,请在提交 Feed 时添加备注说明此请求,或与 Waze 团队联系,以便我们调整轮询周期以反映您的 Feed 更新周期。
XML 验证
Waze 使用以下 XML 架构来定义封闭和突发事件 Feed 规范 (CIFS) Feed 的可接受结构: https://www.gstatic.com/road-incidents/cifsv2.xsd。
互联网上有许多工具可以帮助您 验证 XML Feed 的结构。这些工具包括但不限于 :
- http://www.w3.org/XML/Schema#Tools
- http://www.xml.com/pub/a/2000/12/13/schematools.html
- http://xmlsoft.org/xmllint.html
Feed 的重大更改
在进行以下任何更改之前,请填写 此表单 并修改门户中的请求,以告知 Waze 团队并指明更新后的 Feed。
- 修改、添加或移除 Feed 中的区域或国家/地区。
- 更新 Feed 网址或访问信息所需的任何凭据。
- 更改 Feed 结构或标记名称。
Feed 规范
单个 Feed 文件可以提供有关多个封闭和 突发事件的信息。如果您提供有关多个事件的信息,则必须在单独的元素中详细说明每个封闭 或突发事件,并且必须具有唯一的 ID。这些 部分应使用当地时间和日期。CIFS 规范 详细说明了可用于描述突发事件和封闭的所有标记。