封路信息

您可以使用 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 地图上报告的位置的主要或备用道路名称进行匹配。完全匹配或部分匹配将有助于我们正确识别要关闭的道路，尤其是在存在多条可选道路的情况下。
      • 示例：I-95S、I-95 Southbound 和 JFK Memorial Highway 都可以成功匹配同一条公路。
    • 若要确保您在商品详情中提供的街道和道路名称与 Waze 地图中的名称相符，请使用 Waze Reverse Geocoding API 或检查 Waze 地图编辑器。
  • 只能对以下类型的 Waze 道路关闭 Feed：
    • 高速公路
    • 公路
    • 城市街道
    • 匝道
    • 私有道路
  • 无法使用 Feed 关闭的 Waze 道路类型包括：
    • 停车场道路
    • 越野 (4x4) 和步行道
  • 开始时间和结束时间：
    • 开始时间：您必须提供停业的开始时间。如果您不确定开始时间，可以使用初始报告的时间戳，但在发布事件后不要修改开始时间。
    • 结束时间：如果您不知道结束时间，请将其留空。没有结束时间的闭包将指定默认时长（目前为 2 周），之后将会过期，除非通过指定新的结束时间来明确延长该闭包的期限。您可以在发布活动后修改结束时间，但请避免根据当前时间动态设置结束时间。

    如需详细了解 Closure 和事件 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>2016-04-07T09:00:00+01:00</starttime>
    <endtime>2016-04-07T23:00:00+01:00</endtime>
    <description>Closure on I-95 NB due to construction</description>
    <direction>BOTH_DIRECTIONS</direction>
  </incident>
</incidents>

    JSON 闭包

    以下是一个 JSON 格式包含一条封路的 Feed 文件示例：

    {
  "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": "2016-04-07T09:00:00+01:00",
        "endtime": "2016-04-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>2017-07-04T13:31:17-04:00</creationtime>
      <updatetime>2017-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>2017-06-05T00:01:00-04:00</starttime>
      <endtime>2017-11-22T15:30:00-05:00</endtime>
    </incident>
    <incident id="zxf3kvmrpf">
      <creationtime>2017-08-04T13:31:30-04:00</creationtime>
      <updatetime>2017-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>2017-04-18T00:01:00-04:00</starttime>
      <endtime>2017-12-31T23:59:00-05:00</endtime>
    </incident>
</incidents>

    JSON Feed 文件

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

    {
  "incidents": [
    {
      "id": "3f4r45ff233",
      "creationtime": "2017-07-04T13:31:17-04:00",
      "updatetime": "2017-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": "2017-06-05T00:01:00-04:00",
      "endtime": "2017-11-22T15:30:00-05:00",
      "type": "ROAD_CLOSED"
    },
    {
      "id": "zxf3kvmrpf",
      "creationtime": "2017-08-04T13:31:30-04:00",
      "updatetime": "2017-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": "2017-04-18T00:01:00-04:00",
      "endtime": "2017-12-31T23:59:00-05:00"
    }
  ]
}