封路信息

您可以使用 Waze 合作伙伴 Feed 自动大规模提供计划性封路和实时封路信息。

您发送给 Waze 的计划性封路信息将显示在 Waze 地图编辑器中，并会在封路实际发生期间显示在 Waze 应用中。

仅在道路上的所有车道都封闭时提供封路信息。如果封路仅影响部分车道，请在车道影响元素中说明受影响的车道。

为了确保封路信息准确显示在地图上，您应遵循以下准则和 CIFS 规范。

如果您的 Feed 不符合 CIFS 规范，但包含所有必需数据，Waze 可能仍能处理它。通过合作伙伴中心提交 Feed，以便我们进行验证并提供反馈。

如果数据不完整或不兼容，相应封路信息不会自动显示在地图上，而是会作为“地图问题”发送给我们的编辑者社区，以供人工审核、审批或拒绝。

共享闭包

1. 指定闭合标记

如需绘制封闭道路，请将 ROAD_CLOSED 指定为 type 元素的标记输入。

2. 构建闭包

如需与 Waze 共享封闭，请指定 polyline（必需）和 direction（请求）。

  • 多段线是一系列坐标，沿着道路几何图形，描述应封闭的道路路段。
  • 多段线中的坐标顺序可告诉我们受影响的车流方向。
  • direction 表示封路是否适用于交通的一个方向还是两个方向。

对于单向道路上的封路：

  • 多段线中点的顺序必须与交通方向一致。
  • 为避免歧义并克服映射差异，建议您为单向道路也指定 ONE_DIRECTION。

对于双向道路上的封路：

  • 如果封闭仅影响一个方向：多段线中的坐标顺序会告诉我们要封闭哪个车道。
  • 如果封闭会影响双向车道：共享多段线，并在“方向”字段中指明 BOTH_DIRECTIONS。

对于从 A 点延伸到 B 点的多段线，封路会根据方向和道路类型影响交通方向，如下所示：

一张图片，说明了多段线和方向行为。

3. 调整多段线的形状

  • 多段线越接近相应道路的几何图形，Waze 就越有可能正确匹配它并处理封路。
    强烈建议为起点坐标和终点坐标之间的每个路段提供多个点。对于短路段或直线路段，只提供 2 个坐标可能就足够了，但这通常会导致处理失败。
    以下多段线正确保留了道路的一般形状：

    上下文中使用的多段线图像。
    以下多段线仅提供了起点和终点坐标，因此无法清晰反映道路几何图形：

    上下文中使用的多段线图像。

  • Waze 将使用您提供的多段线将事件应用于 Waze 地图上的一个或多个路段。请注意，应用的关闭路线可能比多段线长或略短，因为 Waze 只能关闭 Waze 地图上配置的整个路段。
  • 如果您仅指定了要关闭的路段的一部分，则整个路段都将关闭。
  • 建议封路的起点和终点之间至少相距 30 米。
  • 所提供的多段线的长度不得超过 20 公里。

4. 请确保您的关闭通知符合以下准则：

  • 街道名称
    • 封路只能影响 Waze 地图上的一条街道或道路。封路的起始坐标和结束坐标必须具有相同的街道名称。报告的封闭路段如果跨越不同的街道名称，则可能会无法处理，即使提供了确切的多段线也是如此。
    • Waze 会尝试将您提供的街道名称与 Waze 地图上所报告位置的主要道路名称或其他道路名称进行匹配。完全匹配或部分匹配有助于我们正确识别要封闭的道路，尤其是在存在多个候选道路时。
      • 示例：I-95S、I-95 Southbound 和 JFK Memorial Highway 都将成功匹配到同一条道路。
    • 为确保您在商家信息中提供的街道和道路名称与 Waze 地图中的名称一致，请使用 Waze Reverse Geocoding API 或查看 Waze 地图编辑器。
  • 封路 Feed 只能用于以下 Waze 道路类型：
    • 高速公路
    • 公路
    • 城市街道
    • 匝道
    • 私有道路
  • 无法报告步道上的封路信息。
  • 开始时间：
    • 您必须提供关闭的开始时间。
    • 如果您不确定开始时间，可以使用初始报告的时间戳。
    • 开始时间修改：
      • 有效关闭：关闭的开始时间一旦过去（即关闭处于有效状态），就不得修改开始时间。
      • 未来的封闭时间：对于尚未开始的封闭时间，您可以根据需要修改开始时间。不过，请确保 event_id 保持不变，以保持一致性。
  • 结束时间：
    • 如果您不知道结束时间，请将其留空。没有结束时间的关闭时间将被分配默认时长（目前为 2 周），除非通过指定新的结束时间明确延长，否则将过期。您可以在发布活动后修改结束时间，但请避免根据当前时间动态设置结束时间。

如需详细了解关闭和事故 Feed 规范 (CIFS) 标记，请参阅 CIFS 规范。

闭包示例

以下示例展示了 XML 和 JSON 格式的单个封路。

XML 闭包

以下是一个采用 XML 格式、包含一条封路信息的 Feed 示例：

<incidents>
  <incident id="101">
    <type>ROAD_CLOSED</type>
    <subtype>ROAD_CLOSED_CONSTRUCTION</subtype>
    <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>
    <street>NW 12th St</street>
    <starttime>2024-06-07T09:00:00+01:00</starttime>
    <endtime>2024-06-07T23:00:00+01:00</endtime>
    <description>Closure on I-95 NB due to construction</description>
    <direction>BOTH_DIRECTIONS</direction>
  </incident>
</incidents>

JSON 闭包

以下示例显示了一个 Feed 文件，其中包含 JSON 格式的一条封路信息：

{
  "incidents": [
    {
      "incident": {
        "id": "101",
        "type": "ROAD_CLOSED",
        "subtype": "ROAD_CLOSED_CONSTRUCTION",
        "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",
        "street": "NW 12th St",
        "starttime": "2024-06-07T09:00:00+01:00",
        "endtime": "2024-06-07T23:00:00+01:00",
        "description": "Closure on I-95 NB due to construction",
        "direction": "BOTH_DIRECTIONS"
      }
    }
  ]
}

以下示例展示了 XML 和 JSON 格式的完整封路 Feed 文件。

XML Feed 文件

以下是 XML 格式的完整封路 Feed 文件示例：

<?xml version="1.0" ?>
<incidents xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/road-incidents/cifsv2.xsd">
    <incident id="3f4r45ff233">
      <creationtime>2024-07-04T13:31:17-04:00</creationtime>
      <updatetime>2024-11-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <description>Complete road closure due to road works</description>
      <street>N Liberty St</street>
      <direction>BOTH_DIRECTIONS</direction>
      <polyline>42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266</polyline>
      <starttime>2024-06-05T00:01:00-04:00</starttime>
      <endtime>2024-11-22T15:30:00-05:00</endtime>
    </incident>
    <incident id="zxf3kvmrpf">
      <creationtime>2024-08-04T13:31:30-04:00</creationtime>
      <updatetime>2024-12-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <subtype>ROAD_CLOSED_CONSTRUCTION</subtype>
      <description>PLANNED ROAD CLOSURE St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31.</description>
        <street>St John's Sideroad</street>
        <direction>BOTH_DIRECTIONS</direction>
        <polyline>44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426</polyline>
      <starttime>2024-04-18T00:01:00-04:00</starttime>
      <endtime>2024-12-31T23:59:00-05:00</endtime>
    </incident>
</incidents>

JSON Feed 文件

以下是 JSON 格式的完整封路 Feed 文件示例：

{
  "incidents": [
    {
      "id": "3f4r45ff233",
      "creationtime": "2024-07-04T13:31:17-04:00",
      "updatetime": "2024-11-17T04:40:41-05:00",
      "description": "Complete road closure due to road works",
      "street": "N Liberty St",
      "direction": "BOTH_DIRECTIONS",
      "polyline": "42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266",
      "starttime": "2024-06-05T00:01:00-04:00",
      "endtime": "2024-11-22T15:30:00-05:00",
      "type": "ROAD_CLOSED"
    },
    {
      "id": "zxf3kvmrpf",
      "creationtime": "2024-08-04T13:31:30-04:00",
      "updatetime": "2024-12-17T04:40:41-05:00",
      "description": "St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31. ",
      "type": "ROAD_CLOSED",
      "subtype": "ROAD_CLOSED_CONSTRUCTION",
      "street": "St John's Sideroad",
      "direction": "BOTH_DIRECTIONS",
      "polyline": "44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426",
      "starttime": "2024-04-18T00:01:00-04:00",
      "endtime": "2024-12-31T23:59:00-05:00"
    }
  ]
}