通行止め情報
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 Southbound、JFK メモリアル ハイウェイはすべて同じ道路にマッチします。
- リスティングで指定した通りや道路名が Waze マップの名前と一致するようにするには、Waze Reverse Geocoding API を使用するか、Waze マップエディタをチェックします。
- フィード閉鎖は、以下の Waze の道路タイプでのみ行うことができます。
- 高速道路
- 高速道路
- 市街地
- ランプ
- 私道
- 以下は、フィードを使用して閉鎖できない Waze の道路タイプです。
- 駐車場の道路
- オフロード(4x4)および歩行者専用道路
- 開始時間と終了時間:
- 開始時間: 閉鎖の開始時間を指定する必要があります。開始時間が不明な場合は、最初のレポートのタイムスタンプを使用してもかまいませんが、イベントを公開した後に開始時間を変更しないでください。
- 終了時間: 終了時間が不明な場合は、空白のままにします。終了時間のないクロージングにはデフォルトの期間(現在は 2 週間)が割り当てられ、新しい終了時間を指定して明示的に延長しない限り、期限切れになります。終了時刻はイベントを公開した後に変更できますが、現在時刻に基づいて動的に設定することは避けてください。
Closure and Incident Feed Specification(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>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 のクロージャ
以下は、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": "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" } ] }