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 桁以上が理想的です。 座標の順序は、影響を受けるトラフィックの方向を反映している必要があります。 トラフィックの方向を 1 つの地点から割り出することはできません。 次のポリラインは、一方の通行方向に影響を及ぼします( <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 | 必須 | 自由形式のテキスト | イベントが発生している道路の名前を指定します。Waze の地図と一致する必要があります。 <street>NW 12th St</street> |
starttime | 必須 | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
1 つの中断期間の開始日時を指定します。ROAD_CLOSED タイプ以外のインシデントの場合は省略できます。この場合、インシデントが現在アクティブであるとみなされます。 タイムスタンプは、ISO8601 形式で秒単位で指定し、タイムゾーン オフセットを含める必要があります。 <starttime>2023-04-07T09:00:00+01:00</starttime> |
終了時刻 | リクエスト済み | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
ISO8601 形式を使用して終了日時を秒単位で指定し、タイムゾーン オフセットを含めます。 省略した場合、現時点では開始時間から 14 日後がデフォルトになります。 <endtime>2023-04-07T23:00:00+01:00</endtime> |
description | リクエスト済み | 自由形式のテキスト | トラフィックが中断した原因。この説明は 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> |
インシデントと閉鎖のサブタイプ
事象の特徴について詳しく教えてください。使用できるサブタイプは、指定されたタイプによって決まります。
種類 | 利用可能なサブタイプ |
---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|