インシデント
インシデントデータは、道路の特定のセクションに影響を与える個別のイベントに関する情報を提供します。 インシデントの例としては、閉鎖、道路工事、事故などがあります。
リクエストパラメータ
フローデータまたはインシデントデータを取得する場合は、次の2つの必須リクエストパラメータがあります。
-
in
- 地理空間フィルタ -
locationReferencing
- 返される位置の参照
これらのパラメーターの使用方法の詳細について は、「地理空間 フィルター」および「位置参照」を参照してください。
さらに、オプションのフィルタパラメータもあります。
-
functionalClasses
は、表示されている道路の機能道路クラスによって、レスポンスの位置をフィルタリングします。 詳細について は、フローのユースケース「機能クラスによるインシデントのフィルタリング」を参照してください。 -
criticality
は、インシデントのCriticalityフィールドでフィルタリングします -
type
は、[ インシデントタイプ ] フィールドでフィルタリングします -
earliestStartTime
とlatestEndTime
は、 インシデントのフィールドstartTime
および endTime
でそれぞれフィルタリングします
このパラメータlang
は、インシデント のフィールドdescription
と summary
が特定の言語で返されるように要求するために使用されます。 詳細については、「 別の言語でインシデントをリクエストする」を参照してください。
ID でインシデントをリクエスト
1つのインシデントに対してID別にリクエストを作成することもできます。 originalId
フィールドの値を使用する必要があります( 使用可能なフィールドの詳細については、以下のIDを参照してください)。 この場合 、パラメーターlocationReferencing
のみが必須であり、 パラメーターin
は使用できません。
詳細については、インシデントユースケース「リクエストインシデント - ID 別」を参照してください。
レスポンスデータモデル
インシデントエンドポイントからの応答には、インシデントオブジェクトのリストとソースデータの最終更新日時が表示されます。
インシデントが ID によってリクエストされると、リストではなく 1 つのインシデントオブジェクトが返されます。
各インシデント オブジェクトは、位置参照を含む フィールドlocation
と、インシデントの特定の詳細を含む フィールドincidentDetails
で構成されます。
位置参照オブジェクトについては、「 位置参照」で説明します。
ID
各インシデントには、複数の ID が添付されている場合があります
-
id
- インシデントバージョンの識別子。同じインシデントの更新時に変更されることがあります。 -
originalId
- 一連の更新で最初に発生したインシデントの ID 。 この値は、インシデントの更新後も安定しています。 -
parentId
- このインシデントがリンクされている別のインシデントの ID 。 たとえば、事故が原因の渋滞アイテムである場合、この識別子は事故インシデントを参照します。
Codes と Type
各インシデントには、インシデントが表すイベントを指定する 2 つのフィールドがあります。
このフィールドtype
は、インシデントの一般的なグループを示す列挙値です。 この 列挙型 (enum) は将来延長される可能性があります。 現在の値は次のとおりです。
-
accident
- 衝突が発生したことを示します -
construction
- 建物または道路工事が行われていることを示します -
congestion
- 車両の集積があったことを示します -
disabledVehicle
- 車両が動けず、道路を妨害していることを示します。 -
massTransit
- 公共交通機関に関連するイベントが存在することを示します -
plannedEvent
- 組織化されたイベントが発生して中断が発生していることを示します -
roadHazard
- 道路の表面に危険物があることを示します -
roadClosure
- 道路が閉鎖されたことを示します ( 警察など ) -
weather
- 気象条件が原因で混乱が発生していることを示します -
laneRestriction
- 一部のレーンにアクセス制限があることを示します -
other
- 上記の種類の問題について説明できない問題が発生したことを示します
このフィールドcodes
には、 AlertC 仕様に基づいてインシデントの原因を説明するコードの優先順位の高いリストが表示されます。
コードは重要度の高い順に提供されるため、リストの最初のアイテムがインシデントの主な原因と見なされます。
AlertC 仕様のすべてのコードの一覧については、 ISO 14819-2 : 2013 を参照してください。
Criticality
緊急度フィールドは、インシデントの重大度を表します。 次の値があります。
-
low
- 重大度が最も低い minor
major
-
critical
- 最も深刻
クリティカリティを使用してユーザーインターフェースを視覚的に表示できますが、その値からそれ以上の情報を推測することはできません。
時間
1 つのインシデントには、最大 3 つの時間フィールドが含まれている すべてのフィールドは、 RFC 3339 のセクション 5.6 に従って、 date-time
で定義されているように書式設定されています。 時刻は常に UTC で明示的に指定されます ( 文字列はZ
で終わります ) 。
-
startTime
- インシデントが有効である時間。この時間よりも前には、インシデントを考慮しないでください。 -
endTime
- インシデントが有効な期間。この期間をすぎると、インシデントは考慮されません。 -
entryTime
- インシデントがシステムに入力された時刻。
道路閉鎖
インシデントには 、道路を走行できないようにインシデントが発生したかどうかを示すフラグroadClosed
が常に含まれています。
ジャンクションのTravesability
ジャンクションのTraversabiliyを示します。 通行止めに伴う交差点を通行できるかどうかを示すために、通行止めに使用されます。
-
allOpen
- すべてのジャンクションは、開放 -
allClosed
- すべてのジャンクションは閉鎖 -
intermediateClosedEdgeOpen
- 道路の始点と終点のジャンクションが開いています。中間のジャンクションが閉じられています -
startOpenOthersClosed
- 最初のエッジジャンクションは、開放、他のすべてのジャンクションが閉鎖 -
endOpenOthersClosed
- 最後のエッジジャンクションは、開放、他のすべてのジャンクションは閉鎖
デフォルト値はallOpen
です 。このフィールドは、値がこのデフォルトと異なる場合にのみ表示されます。
制限事項
指定した道路を通行できる車両に適用されている制限のリスト。 この制限は一時的なもので、インシデントが存在する限り適用されます。 車両が制限条件に該当する場合、そのエリアを通過することは許可されていません。
一覧表の各制限には、車両タイプと制限タイプがあります。 車両タイプの現在の値は次のとおりです。
bus
car
heavyGoodsVehicle
lorry
motorcycle
motorVehicle
taxi
train
transportingAnAbnormalSizeLoad
transportingHazardousGoods
vehicleWithTrailer
other
制限タイプは、次のいずれかです。
-
sizeRestriction
- 車両の車高、車長、または車幅のいずれかをセンチメートル単位で測定し、そのエリアを通過できる制限車両。 この制限には 、制限を適用するディメンションを定義するdimension
フィールドと 、lessThan
または greaterThan
のいずれかのラベルで制限値を定義するvalue
フィールドがあります。 -
weightRestriction
- エリアを通過できる車両重量の制限 (kg) 。 この制限には 、weightPerAxle
またはgrossWeight
のいずれかのウェイトタイプを定義するweight_type
フィールド と 、lessThan
または greaterThan
のいずれかのラベルを使用して値を定義するvalue
フィールドがあります。 -
vehicleOccupancyRestriction
-エリアを通過できる車内の乗客数の制限。 lessThan
ラベルまたは greaterThan
ラベルのいずれかを持つ単一の値があります。 -
emissionRestriction
-車両の排出ガスクラスの制限。 可能な値は次のとおりです。 emissionEuro3
emissionEuro3d4
emissionEuro4
emissionEuro5
-
equipmentTypeRestriction
-車両装備の制限。 可能な値は次のとおりです。 withCaravan
withTrailer
withoutSnowChains
withoutWinterTyres
-
fuelTypeRestriction
-車両の燃料タイプの制限。 可能な値は次のとおりです。 -
TrafficTypeRestriction
-トラフィックのタイプの制限。 可能な値は次のとおりです。 residentsTraffic
throughTraffic
noThrough
-
plateNumberRestriction
-車両のプレート番号の制限。 可能な値は次のとおりです。 evenNumberPlate
oddNumberPlate
概要と説明
各インシデントには、判読可能な言語でインシデントを記述する 2 つのテキストフィールドが含まれています これらのフィールドは、エンド ユーザーに表示するのに適しています。
このフィールドには、位置情報を含まない簡単な説明が表示されます。summary
概要の例 :
- 「建設工事。 車線が閉鎖されました。」
- 「 通過トラフィックがありません 」
- " 道路工事により閉鎖されました。 」
このフィールドdescription
には、より長いテキストの説明が表示されます。場合によっては、位置情報も含まれます。
説明例 :
- 「Foster City Blvd と San Mateo County Fishing Pier の間 - 建設工事。 車線が閉鎖されました。 」
- 「Shattuck Ave と Howell St の間 - 渋滞なし」
- 「 I-80/ Miller Ave では道路工事のため閉鎖中です。」