インシデントデータをリクエストする

基本的なインシデントリクエストは、地理空間フィルター(in)と返される位置の参照タイプ(locationReferencing)で構成されます。

レスポンスには、リクエストされたエリア内にある道路セグメントのインシデントが含まれます。

地理空間フィルターinには円、バウンディングボックス、コリドーを使用でき、それぞれ独自の形式を持ちます。

以下の例では、緯度、経度が示す点と半径で指定された円を使用しています。

in=circle:52.50811,13.47853;r=2000。

地理空間のフィルタリングタイプの詳細については、「地理空間をフィルタリングする」を参照してください。

locationReferencingにはtmc、olr、shapeの1つ以上を指定できます。位置のタイプには解釈できるもののみを指定し、処理できないデータを取得しないようにします。

📘
注
インシデント情報の位置に興味がない場合はnoneを指定してください。レスポンスに位置参照が含まれなくなります。

位置の参照タイプの詳細については、「位置の参照」を参照してください。

返されるデータはインシデントアイテムの配列であり、それぞれにlocationとincidentDetails要素があります。

各locationには、メートル単位のlengthと、その場所で利用可能な位置の参照 (locationReferencingパラメーターでリクエストされたタイプに応じる) が含まれます。

各インシデントアイテムのincidentDetails要素には、開始時刻と終了時刻、AlertCコード、インシデントの説明などの詳細情報が含まれます。

curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/incidents?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr"

{
   "sourceUpdated": "2021-07-06T10:22:01Z",
   "results": [
       {
           "location": {
               "length": 9310.0,
               "olr": "CCkBEAAlJAUSUiRTrwAJBQQAAZAACgUEAMhIANOV8MIACQUEAAEtADAAAA=="
           },
           "incidentDetails": {
               "id": "3195531507295233286",
               "originalId": "3195531507295233286",
               "startTime": "2019-12-03T23:00:00Z",
               "endTime": "2023-03-12T22:59:59Z",
               "entryTime": "2021-07-04T02:18:03Z",
               "roadClosed": true,
               "criticality": "minor",
               "type": "other",
               "typeDescription": {
                   "value": "Sonstige Neuigkeiten",
                   "language": "de-DE"
               },
               "codes": [
                   803,
                   1851
               ],
               "description": {
                   "value": "Bei Leverkusen - Vorübergehende Begrenzung der Breite 7.0 m. Bauarbeiten auf Abschnitt."
               },
               "summary": {
                   "value": "Bei Leverkusen - Vorübergehende Begrenzung der Breite 7.0 m. Bauarbeiten auf Abschnitt."
               },
               "vehicleRestrictions": [
                   {
                       "vehicleType": "motorVehicle",
                       "restrictionType": {
                           "size": {
                               "dimension": "width",
                               "value": {
                                   "greaterThan": 0.0
                               }
                           }
                       }
                   }
               ]
           }
       },
       {
           "location": {
               "length": 2087.0,
               "olr": "CCsBEAAnJgT0kSRLKwAJBQQAAa4ACgUEAJZ4APN5+WUACQUEAAEmADCCKoQq"
           },
           "incidentDetails": {
               "id": "3704457286517849505",
               "originalId": "3704457286517849505",
               "startTime": "2021-07-04T02:18:01Z",
               "endTime": "2025-12-31T22:59:00Z",
               "entryTime": "2021-07-04T02:18:03Z",
               "roadClosed": true,
               "criticality": "major",
               "type": "other",
               "typeDescription": {
                   "value": "Sonstige Neuigkeiten",
                   "language": "de-DE"
               },
               "codes": [
                   494,
                   803,
                   1851
               ],
               "description": {
                   "value": "Zwischen Leverkusen-West und Köln-Niehl - Vorübergehende Begrenzung der Breite 2.3 m. Bauarbeiten auf Abschnitt. Gesperrt für Schwerlastverkehr über 3.5 t."
               },
               "summary": {
                   "value": "Zwischen Leverkusen-West und Köln-Niehl - Vorübergehende Begrenzung der Breite 2.3 m. Bauarbeiten auf Abschnitt. Gesperrt für Schwerlastverkehr über 3.5 t."
               },
               "vehicleRestrictions": [
                   {
                       "vehicleType": "lorry",
                       "restrictionType": {
                           "weight": {
                               "weightType": "vehicleWeight",
                               "value": {
                                   "greaterThan": 0.0
                               }
                           }
                       }
                   }
               ]
           }
       },
       ...
   ]
}

上のresults配列は、読みやすいように省略されています。

description、typeDescription、summaryが使用する言語は、インシデントが所属する国の標準語です。元の言語が利用できない場合、typeDescriptionは米国英語で提供されます。

別の言語で情報を取得するには、langパラメーターを使用します (たとえば米国英語ならlang=en-US)。

リクエストされた場所で利用できる交通情報がない場合、resultsは空の配列になります。

{"sourceUpdated":null,"results":[]}