通行止め情報

Waze Partner フィードを使用すると、通行止めを予定的かつリアルタイムに自動的かつ大規模に提供できます。

Waze に送信した通行止めは Waze Map Editor に表示され、通行止めの実際の時間中に Waze アプリに表示されます。

道路のすべての車線が通行止めになっている場合にのみ、通行止めを指定してください。通行止めが一部の車線にのみ影響する場合は、車線影響の要素で影響を受ける車線について説明してください。

通行止めを正確に地図に表示するには、以下のガイドラインと CIFS の仕様に従ってください。

フィードが CIFS の仕様に準拠していなくても、必要なデータがすべて含まれている場合、Waze はそれを処理できることがあります。検証とフィードバックのため、Partner Hub からフィードを送信してください。

データが不完全または互換性がない場合、通行止めは自動的に地図に表示されませんが、Google のエディター コミュニティに「地図の問題」として送信され、手動での審査、承認、不承認となります。

クロージングの共有

1. 閉鎖タグを指定する

通行止めを地図に表示するには、type 要素のタグ入力として ROAD_CLOSED を指定します。

2. 締めくくりを構成する

Waze と閉鎖情報を共有するには、polyline(必須)と direction(リクエスト)を指定します。

  • ポリラインは、道路のジオメトリに沿った一連の座標で、閉鎖する必要がある道路の範囲を表します。
  • ポリラインの座標の順序から、影響を受ける通行方向がわかります。
  • direction は、通行止めが片方向または両方向の交通に適用されるかどうかを示します。

一方通行の道路の通行止めの場合:

  • ポリライン内のポイントの順序は、交通の流れと一致している必要があります。
  • 曖昧さを回避し、マッピングの違いを克服するために、一方通行の道路でも ONE_DIRECTION を指定することをおすすめします。

対面通行が通行止めである場合:

  • 閉鎖が一方向にしか影響しない場合: ポリラインの座標の順序によって、閉鎖する通行方向が判断されます。
  • クロージャが両方向に影響する場合は、ポリラインを共有し、方向フィールドに BOTH_DIRECTIONS を指定します。

点 A から点 B に延びるポリラインの場合、通行止めは道路の進行方向と道路の種類に応じて、以下のように変化します。

ポリラインと方向の動作を説明する画像。

3. ポリラインを形作る

  • ポリラインが道路のジオメトリに近いほど、Waze が正しく一致して通行止めを処理できる可能性が高くなります。
    開始座標と終了座標の間にある各セグメントに複数のポイントを指定することを強くおすすめします。短いセグメントや直線のセグメントの場合は、座標を 2 つだけ指定するだけで十分ですが、多くの場合、それが処理エラーの原因となります。
    次のポリラインは、道路の全体的な形状を正しく維持しています。

    コンテキストで使用されるポリライン画像。
    次のポリラインは、始点と終点の座標のみが指定されているため、道路のジオメトリを明確に反映していません。

    状況に応じて使用されるポリラインの画像。

  • 指定したポリラインを使用して、Waze 地図上の 1 つまたは複数のセグメントにイベントを適用します。Waze は Waze マップ上で設定したようにセグメント全体を閉じることができないため、適用されたクロージャはポリラインより長くなったり短くなったりします。
  • 閉鎖するセグメントの一部のみを指定した場合、セグメント全体が閉鎖されます。
  • 閉鎖の開始点と終了点は、30 m 以上離すことをおすすめします。
  • 指定するポリラインの長さは 20 km 以下にする必要があります。

4. 閉鎖が以下のガイドラインに沿っていることを確認します。

  • 町名 <ph type="x-smartling-placeholder">
      </ph>
    • 通行止めは、Waze 地図上の 1 つの道路にのみ影響します。通行止めの始点と終点の座標は、通りの名前が同じである必要があります。報告された通行止めが異なる道路名にまたがっている場合、正確なポリラインが指定されていても、処理が失敗する可能性があります。
    • Waze は、提供された道路名を、報告された場所の Waze マップ上で、主要な道路名や別の道路名と一致させようとします。完全一致または部分一致を使用すると、特に複数の候補がある場合に、閉鎖する道路を正確に特定できます。
      • 例: 州間高速道路 I-95S、I-95 サウスバウンド、JFK メモリアル ハイウェイはすべて同じ道路に一致します。
    • 掲載情報で指定した道路名や道路名が Waze マップの通りの名前と一致するようにするには、Waze Reverse を使用します。 Geocoding API を使用するか、Waze マップエディタを確認してください。
  • フィードを閉鎖できるのは、次の Waze 道路タイプのみです。 <ph type="x-smartling-placeholder">
      </ph>
    • 高速道路
    • 高速道路
    • 市街地
    • ランプ
    • 私道
  • 通行止めは、歩道のある道路では報告できません。
  • 開始時間:
    • 閉鎖の開始時間を指定する必要があります。
    • 開始時間がわからない場合は、最初のレポートのタイムスタンプを使用できます。
    • 開始時間の変更:
      • アクティブな閉鎖: 閉鎖の開始時間が過ぎた後(つまり、閉鎖が有効になった場合)は、開始時間を変更できません。
      • 今後の休業: まだ開始していない休業については、必要に応じて開始時間を変更できます。ただし、整合性を保つため、event_id は同じである必要があります。
  • 終了時間:
    • 終了時間がわからない場合は、空白のままにします。終了時間が指定されていないクローズにはデフォルトの期間(現在は 2 週間)が割り当てられます。新しい終了時間を指定して明示的に延長しない限り、クローズは期限切れになります。終了時間はイベントを公開した後に変更できますが、現在の時刻に基づいて動的に終了時間を設定することは避けてください。

クローズとインシデント フィードの仕様(CIFS)タグの詳細については、CIFS の仕様をご覧ください。

クロージャの例

次の例は、単一の道路規制を XML 形式と JSON 形式で示しています。

XML クロージャ

XML 形式の 1 つの通行止めを含むフィードの例を次に示します。

<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 閉じ括弧

以下は、1 件の道路規制が 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"
    }
  ]
}