CIFS 仕様
CIFS（Closure and Incident Feed Specification）は、パートナーのフィードでインシデントと道路閉鎖を記述するための Waze の標準プロトコルです。
次のパラメータ表では、各要素を次のように分類しています。
- 必須: 必須タグの値が適切な形式で指定されていない場合、フィードは無効と見なされます。
- リクエスト済み: 技術的には必須ではありませんが、リクエスト済みのタグは推奨と見なされます。
- 省略可: より多くのデータを提供できる省略可能なタグ。
要素の順序は、ファイルを解析するエンジンにとって重要ではありません。
これらのタグは、type タグの値に応じて、インシデントまたは道路閉鎖のいずれかを記述できます。わずかな違いについては、該当する箇所で説明します。
フィード内の通行止めの例
フィード内のインシデントの例
同じフィード ファイル内で通行止めとインシデントを混在させることができます。
CIFS の要素
| 要素 | 必須 | タグの入力 | 説明 |
|---|---|---|---|
| インシデント ID | 必須 | 自由形式のテキスト | 英数字または数値の識別子を指定します。 <incident id="LND11DEayKr">...</incident> |
| type | 必須 | 次のいずれか:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
タイプによって、Waze アプリでイベントがどのように使用されるかが決まります。 他のすべてのタイプは Waze マップに表示され、近くの Wazer にポップアップ通知が表示されますが、ルーティングに直接影響することはありません。 <type>ROAD_CLOSED</type> |
| サブタイプ | リクエスト済み | 許可されているサブタイプのリストをご覧ください。 | 報告されたインシデントのタイプをより正確に説明します。 |
| ポリライン | 必須 | 空白で区切られた lat lon ペアのリスト |
事故や道路閉鎖の位置を表す、10 進数（DD、投影 SRID 4326）の緯度と経度の座標。十分な精度を確保するため、小数点以下は 6 桁以上にするのが理想的です。 座標の順序は、影響を受けるトラフィックの方向を反映している必要があります。 単一のポイントからトラフィックの方向を推定することはできません。 次のポリラインは、一方向の交通に影響します（両方向に影響を与えるには、 <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> |
| direction | リクエスト済み | BOTH_DIRECTIONS または ONE_DIRECTION |
通行止めや規制が道路の片方向または両方向のどちらに影響するかを指定します。 ポリラインが指定されている場合でも、方向を指定することを強くおすすめします。座標のセットを 1 つしか指定できない場合は、イベントが正しい進行方向で表示されるように、方向フィールドが必要です。 <direction>BOTH_DIRECTIONS</direction> |
| street | 必須 | 自由テキスト | イベントが発生している通りまたは道路の名前を指定します。 <street>NW 12th St</street> |
| starttime | 必須 | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
停止期間の開始日時を指定します。タイプが ROAD_CLOSED ではないインシデントでは省略できます。その場合、インシデントは現在アクティブであると想定されます。 タイムスタンプは、秒単位の ISO8601 形式で、タイムゾーン オフセットを含める必要があります。 <starttime>2023-04-07T09:00:00+01:00</starttime> |
| endtime | リクエスト済み | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
終了日時を ISO8601 形式で秒単位で指定し、タイムゾーン オフセットを含めます 省略した場合、デフォルトでは開始時刻から 14 日後に設定されます。 <endtime>2023-04-07T23:00:00+01:00</endtime> |
| 説明 | リクエスト済み | 自由形式のテキスト | 交通機関の運行が中断された原因。この説明は 40 文字未満にする必要があります。40 文字を超える説明も受け付けられますが、Waze アプリで正しく表示されない可能性があります。 <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| レーンへの影響 | オプション | 構造化されたレーンの影響情報 | インシデントが道路の完全な閉鎖ではなく、一方向の交通に影響する場合にのみ、車線への影響に関するデータを提供します。
WZDx レーン形式または同様の形式を使用してレーンの配列を指定し、すべてのレーンに関する情報を提供します。
完全な形式の例: <lanes>
<lane>
<order>1</order>
<type>LANE</type>
<status>CLOSED</status>
</lane>
<lane>
<order>2</order>
<type>LANE</type>
<status>OPEN</status>
</lane>
</lanes>
部分形式の例: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| スケジュール | 省略可 | <dayname>hh:mm-hh:mm</dayname> |
インシデントのすべての開始日時と終了日時をカプセル化します。 <schedule> <monday>09:00-11:00,17:00-21:00</monday> <thursday>09:00-11:00,17:00-21:00</thursday> <friday>09:00-11:00,17:00-21:00</friday> <saturday>00:00-05:00</saturday> <sunday>09:00-18:00</sunday> </schedule> |
Incident And Closures サブタイプ
インシデントの性質について、詳細をご記入ください。許容されるサブタイプは、指定されたタイプによって決まります。
| タイプ | 考えられるサブタイプ |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|