道路封閉資訊

你可以使用 Waze 合作夥伴動態饋給，自動大規模提供預定的道路封閉資訊。

你傳送至 Waze 的預定停業行程資訊會顯示在 Waze Map Editor 中，並於實際關閉期間顯示在 Waze 應用程式中。

只有在道路所有車道封閉的情況下，才提供道路封閉。如果封閉路段僅會影響部分車道，請說明車道影響元素中影響的車道。

為了讓道路準確顯示在地圖上，請遵守下列規範和 CIFS 規格。

如果動態饋給不符合 CIFS 規格，但已納入所有必要的資料，Waze 可能仍可處理。透過合作夥伴中心提交動態饋給以供驗證及意見回饋。

如果資料不完整或不相容，則關閉資訊不會自動顯示在地圖上，但會傳送到「編輯器社群」(「地圖問題」)，以便進行人工審查、核准或拒絕。

分享停業資訊

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 南行、JFK 紀念高速公路 (JFK Memorial Highway) 都會成功對應到同一條道路。
    • 為確保您在商家資訊中提供的街道和道路名稱與 Waze 地圖上的街道名稱相符，請使用 Waze Reverse Geocoding API 或查看 Waze 地圖編輯器。
  • 動態饋給封閉僅適用於以下 Waze 道路類型：
    • 高速公路
    • 高速公路
    • 城市街道
    • 匝道
    • 私人道路
  • 無法使用動態饋給關閉的 Waze 道路類型包括：
    • 停車場
    • 越野車 (4 x 4) 和行人道路
  • 開始和結束時間：
    • 開始時間：必須提供停業的開始時間。如果不確定開始時間，可以使用初始報表的時間戳記，但「請勿」修改事件發布後的開始時間。
    • 結束時間：如果不知道結束時間，請留白。系統會為沒有結束時間的閉包指派預設時間長度 (目前為 2 週)，除非明確指定新的結束時間，否則會失效。您可以在發布活動後修改結束時間，但避免根據目前時間動態設定結束時間。

    如要進一步瞭解閉包及事件動態饋給規格 (CIFS) 標記，請參閱 CIFS 規格。

    結案示例

    以下範例顯示 XML 和 JSON 格式的單一道路封閉情形。

    XML 關閉

    以下是含有單一道路封閉情形的動態饋給範例 (XML 格式)：

    <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 格式：

    {
  "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 格式的完整道路封閉動態饋給檔案。

    XML 動態饋給檔案

    以下是 XML 中完整道路封閉動態饋給檔案的範例：

    <?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 動態饋給檔案

    以下是採用 JSON 格式的完整道路封閉動態饋給檔案範例：

    {
  "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"
    }
  ]
}