道路封閉資訊

您可以使用 Waze 合作夥伴動態饋給，自動且大規模地提供預定和即時道路封閉資訊。

您傳送給 Waze 的預定封路資訊會顯示在 Waze 地圖編輯器中，並在封路期間顯示在 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 會嘗試在您回報的地點，將您提供的街道名稱與 Waze 地圖上的主要或替代道路名稱比對。完整或部分比對可協助我們正確識別要封閉的道路，特別是在有多個候選路段時。
      • 範例：I-95S、I-95 Southbound 和 JFK Memorial Highway 都會成功比對到同一條道路。
    • 為確保你在商家資訊中提供的街道和道路名稱與 Waze 地圖上的名稱相符，請使用 Waze 反向地理編碼 API 或查看 Waze 地圖編輯器。
  • 動態饋給封閉功能僅適用於下列 Waze 道路類型：
    • 高速公路
    • 高速公路
    • 城市街道
    • 匝道
    • 私人道路
  • 無法回報行人道上的道路封閉情形。
  • 開始時間：
    • 你必須提供關閉時間的開始時間。
    • 如果不確定開始時間，可以使用初始報表的時間戳記。
    • 開始時間修改：
      • 有效關閉：關閉的開始時間已過 (也就是關閉處於有效狀態)，則不得修改開始時間。
      • 未來的停工：如果停工時間尚未開始，您可以視需要修改開始時間。不過，請務必保持 event_id 一致，以維持一致性。
  • 結束時間：
    • 如果不知道結束時間，請留空。系統會為沒有結束時間的關閉作業指派預設時間長度 (目前為 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>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 結束符號

以下是 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 格式顯示完整的道路封閉動態饋給檔案。

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

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

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