通行止め情報
Waze パートナー フィードを使用すると、計画的な通行止めとリアルタイムの通行止めを自動的に大規模に提供できます。
Waze に送信した通行止め予定は、Waze マップ エディタに表示され、通行止めが実際に実施される時間帯には Waze アプリにも表示されます。
道路のすべての車線が通行止めになっている場合にのみ、通行止めを指定してください。通行止めが一部車線にのみ影響する場合は、車線への影響要素で影響を受ける車線を説明します。
通行止めを地図に正確に表示するには、以下のガイドラインと CIFS 仕様に準拠する必要があります。
フィードが CIFS 仕様に準拠していないが、必要なデータがすべて含まれている場合、Waze で処理できることがあります。Partner Hub からフィードを送信して、検証とフィードバックを受けます。
データが不完全または互換性がない場合、通行止めは地図に自動的に表示されず、「地図の問題」としてエディタ コミュニティに送信され、手動で審査、承認、不承認が行われます。
クローズを共有する
1. 閉鎖タグを指定する
通行止めを地図に表示するには、type
要素のタグ入力として ROAD_CLOSED
を指定します。
2. 結びを構成する
Waze と閉鎖情報を共有するには、polyline
(必須)と direction
(リクエスト)を指定します。
- ポリラインは、道路ジオメトリに沿って、閉鎖する必要がある道路の区間を記述する一連の座標です。
- ポリライン内の座標の順序は、影響を受ける交通方向を示します。
direction
は、通行止めが片方向または両方向のどちらに適用されるかを示します。
一方通行の道路の通行止めの場合:
- ポリライン内のポイントの順序は、交通の流れと一致している必要があります。
- 曖昧さを回避し、マッピングの違いを克服するために、一方通行の道路でも
ONE_DIRECTION
を指定することをおすすめします。
片側通行の道路の通行止めの場合:
- 通行止めが片方向にのみ影響する場合: ポリラインの座標の順序で、通行止めにする交通方向がわかります。
- 通行止めが両方向に影響する場合: ポリラインを共有し、方向フィールドに
BOTH_DIRECTIONS
を指定します。
ポイント A からポイント B に延びるポリラインの場合、通行止めは、次のように、道路の方向と道路の種類に基づいて交通の流れに影響します。
3. ポリラインを形作る
ポリラインが道路のジオメトリに近いほど、Waze が正しく一致して通行止めを処理できる可能性が高くなります。
開始座標と終了座標の間にある各セグメントに複数のポイントを指定することを強くおすすめします。短いセグメントや直線セグメントの場合は 2 つの座標のみを指定するだけで十分ですが、処理エラーの原因となることがよくあります。
次のポリラインは、道路の全体的な形状を正しく維持しています。
次のポリラインは、始点と終点の座標のみが指定されているため、道路のジオメトリを明確に反映していません。
- Waze は、指定されたポリラインを使用して、Waze マップの 1 つ以上のセグメントにイベントを適用します。Waze では Waze マップで設定されているように、セグメント全体を閉じることができるため、適用される閉鎖はポリラインよりも長くなる場合や、少し短くなる場合があります。
- 閉鎖するセグメントの一部のみを指定した場合、セグメント全体が閉鎖されます。
- 閉鎖の開始点と終了点は、30 m 以上離すことをおすすめします。
- 指定するポリラインの長さは 20 km を超えないようにしてください。
4. 閉鎖が次のガイドラインに準拠していることを確認してください。
- 道路名
- 通行止めは、Waze 地図上の 1 つの道路にのみ影響します。通行止めの開始地点と終了地点の座標には、同じ道路名を指定する必要があります。通行止めが複数の道路名にまたがっている場合、正確なポリラインが指定されていても、処理が失敗する可能性があります。
- Waze は、指定された道路名を、報告された場所の Waze 地図上の主要道路名または代替道路名と照合しようとします。完全一致または部分一致は、特に複数の候補がある場合に、閉鎖する道路を正しく特定するのに役立ちます。
- 例: I-95S、I-95 南行き、JFK メモリアル ハイウェイはすべて、同じ道路に正常にマッチングされます。
- リスティングで指定した通り名と道路名が Waze 地図のものと一致するようにするには、Waze の Reverse Geocoding 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" } ] }