インシデント (交通障害)

インシデントデータは、道路の特定のセクションに影響を与える個別のイベントに関する情報を提供します。イベントの例として、閉鎖、道路工事、事故などがあります。

リクエストパラメーター

フローデータまたはインシデントデータを取得するときに必須となるリクエストパラメーターは次の2つです。

in - 地理空間フィルター
locationReferencing - 返される位置の参照

これらのパラメーターの使用方法の詳細については、地理空間フィルターの概念と位置の参照の概念を参照してください。

さらに、次のフィルターパラメーターがあります。

functionalClassesはレスポンスの位置を、それが表す道路の機能道路クラスによってフィルタリングします。詳細については、フローユースケース「機能クラスでインシデントをフィルタリングする」を参照してください。
criticalityは、インシデント重要度フィールドでフィルタリングします
typeは、インシデントタイプフィールドでフィルタリングします
earliestStartTimeとlatestEndTimeは、インシデントのstartTimeフィールドとendTimeフィールドでフィルタリングします

langパラメーターは、インシデントのdescription、typeDescription、summaryの各フィールドが特定の言語で返されるようにリクエストするために使用されます。詳細については、「別の言語でインシデントをリクエストする」を参照してください。

IDでインシデントをリクエストする

また、IDを使用して単一のインシデントに対してリクエストを行うこともできます。originalIdフィールドの値を使用します (使用可能なIDフィールドの詳細については、以下のセクションを参照)。この場合、locationReferencingパラメーターのみが必須であり、inパラメーターは使用できません。

詳細については、インシデントのユースケース「IDでインシデントをリクエストする」を参照してください。

レスポンスデータモデル

インシデントエンドポイントからのレスポンスによって、インシデントオブジェクトのリストとソースデータの最終更新時間が提供されます。

インシデントがIDによってリクエストされた場合、リストの代わりに単一のインシデントオブジェクトが返されます。

各インシデントオブジェクトは、位置参照を含むlocationフィールドと、インシデントの特定の詳細を含むincidentDetailsフィールドで構成されます。

位置参照オブジェクトについては、「位置参照」で説明されています。

ID

各インシデントにはいくつかのIDが添付されています。

id - インシデントバージョンの識別子。同一のインシデントの更新に伴い変更される場合があります。
originalId - 一連の更新における最初のインシデントの識別子。この値はインシデントが更新されても変わりません。
parentId - このインシデントがリンクされている別のインシデントの識別子。たとえば、そのインシデントが事故によって引き起こされた渋滞アイテムである場合、識別子は事故インシデントを参照します。

コードとタイプ

各インシデントには、インシデントが表すイベントを指定する2つのフィールドが含まれています。

typeフィールドは、インシデントの一般的なグループを示す列挙型の値です。この列挙型 (enum) は将来に拡張される可能性があります。現在の値は次のとおりです。

accident - 衝突が発生したことを示す
construction - 建物または道路の工事が行われていることを示す
congestion - 車両が渋滞していることを示す
disabledVehicle - 車両が動けず、通行を妨げていることを示す
massTransit - 公共交通機関に関連するイベントがあることを示す
plannedEvent - 企画イベントが開催中であり、混乱が発生していることを示す
roadHazard - 道路の表面に危険物があることを示す
roadClosure - 警察などにより道路が閉鎖されたことを示す
weather - 気象条件により混乱が発生していることを示す
laneRestriction - 一部の車線にアクセス制限があることを示す
other - 上記のタイプで説明できないインシデントが発生したことを示す

codesフィールドには、AlertC仕様に基づいてインシデントの原因を説明する優先順位の高いコードのリストが表示されます。

コードは重要度の高い順に指定されているため、リストの最初の項目はインシデントの主な原因と考えられます。

AlertC仕様に含まれる全コードのリストについては、「ISO 14819-2:2013」を参照してください。

重要度

重要度フィールドはインシデントの重大度を表します。値は次のとおりです。

low - 最も重要度が低い
minor
major
critical - 最も重要度が高い

重要度は、ユーザーインターフェイスに視覚的な表示を提供するために使用できますが、その値からそれ以上の情報を推測するものではありません。

時間

1つのインシデントには最大3つの時間フィールドが含まれています。すべてのフィールドは、RFC 3339 のセクション5.6に従ってdate-time形式にフォーマットされます。時間は常にUTCで明示的に指定されます(Zで終わる文字列)。

startTime - インシデントが有効になった時間。この時間より前にはインシデントが考慮されません。
endTime - インシデントはこの時間まで有効であり、これを過ぎるとインシデントは考慮されません。
entryTime - インシデントがシステムに入力された時間。

道路の閉鎖

インシデントには、そのインシデントにより道路を走行できなくなったかどうかを示すroadClosedのフラグが必ず含まれています。

ジャンクションでの通行可能性

ジャンクションの通行可能性を示します。閉鎖道路に使用され、ジャンクションを通過できるかどうかを示すために使用されます。

allOpen - すべてのジャンクションが通行可能
allClosed - すべてのジャンクションが閉鎖
intermediateClosedEdgeOpen - 道路の始点と終点のジャンクションは通行可能だが、途中にあるジャンクションが閉鎖
startOpenOthersClosed - 最初のエッジジャンクションは通行可能、他のすべてのジャンクションは閉鎖
endOpenOthersClosed - 最後のエッジジャンクションは通行可能、他のすべてのジャンクションは閉鎖

デフォルト値はallOpenです。フィールドは値がこのデフォルト値と異なる場合にのみ表示されます。

制限

指定した道路を通行できる車両に適用されている制限のリスト。この制限は一時的なもので、インシデントが存在する限り適用されます。車両が制限条件に該当する場合、そのエリアの通過は許可されていません。

リスト内の各制限には、車両タイプと制限タイプがあります。

車両タイプの現在の値は次のとおりです。

bus
car
heavyGoodsVehicle
lorry
motorcycle
motorVehicle
taxi
train
transportingAnAbnormalSizeLoad
transportingHazardousGoods
vehicleWithTrailer
other

制限タイプは次のいずれかになります。

sizeRestriction - センチメートル単位で測定した車高、車長、または車幅のいずれかを基準として、そのエリアを通過できる制限車両。この制限には、制限を適用する大きさを定義するdimensionフィールドと、lessThanまたはgreaterThanのいずれかのラベルで制限値を定義するvalueフィールドがあります。
weightRestriction - エリアを通過できる車両の重量制限 (キログラム)。この制限には、重量タイプをweightPerAxleまたはgrossWeightのいずれかに定義するweight_typeフィールドと、lessThanまたはgreaterThanのいずれかのラベルで値を定義するvalueフィールドがあります。
vehicleOccupancyRestriction - 車両内でエリアを通過できる乗員数の制限。これはlessThanまたはgreaterThanのいずれかのラベルを伴う単一の値です。
emissionRestriction - 車両の排気クラスの制限。指定できる値は次のとおりです。
- emissionEuro3
- emissionEuro3d4
- emissionEuro4
- emissionEuro5
equipmentTypeRestriction - 車両の装備の制限。指定できる値は次のとおりです。
- withCaravan
- withTrailer
- withoutSnowChains
- withoutWinterTyres
fuelTypeRestriction - 車両の燃料タイプの制限。指定できる値は次のとおりです。
- diesel
- lpg
- petrol
TrafficTypeRestriction - トラフィックのタイプに対する制限。指定できる値は次のとおりです。
- residentsTraffic
- throughTraffic
- noThrough
plateNumberRestriction - 車両のナンバープレートの数字による制限。指定できる値は次のとおりです。
- evenNumberPlate
- oddNumberPlate

概要、説明、typeDescription

各インシデントには、人間が読める言語でインシデントを記述する3つのテキストフィールドが含まれています。これらのフィールドは、エンドユーザーへの表示に適しています。

summaryフィールドには短い説明が表示され、位置情報は含まれません。

サマリーの例：

「建設工事。車線が閉鎖されています」
「通行禁止」
「道路工事により閉鎖されています」

descriptionフィールドには長いテキストの説明が表示され、位置情報は含まれません。

説明の例：

「フォスターシティブールバードとサンマテオ郡フィッシングピアの間 - 建設工事。車線が閉鎖されています」
「シャダックアベニューとハウウェルストリートの間 - 渋滞なし」
「I - 80/Millerアベニュー - 道路工事のため閉鎖されています」

typeDescriptionフィールドには、インシデントタイプの簡単な説明が表示されます。

タイプの説明の例を次に示します。

"道路工事"
"レーンごとの規制"
"予定されているイベント"