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

基本的なインシデント リクエストは、地理空間フィルター (in) と返される位置参照のタイプ (locationReferencing) で構成されます。レスポンスには、リクエストされたエリア内にある道路セグメントの交通障害が含まれます。

地理空間フィルタ in は、Circle、Bounding Box、またはCorridorで、それぞれ独自の形式を使用できます。 以下の例では、緯度、経度、半径を含む点で指定されたCircleを使用します。in=circle:52.50811,13.47853;r=2000。

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

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

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

返されるデータはインシデントアイテムの配列で、それぞれに location とincidentDetails要素があり ます。 各 location には、 パラメーターlocationReferencingで要求されたものに応じて、メートル単位のlengthと、その場所の利用可能な位置参照があります。

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

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

curl "https://data.traffic.hereapi.com/v7/flow?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr&apiKey=$API_KEY"

{
   "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",
               "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",
               "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 およびsummaryが使用する言語 は、インシデントが所属する国の標準語です。 別の言語で情報を取得するには、パラメーターlangを使用します (たとえば、米国英語の場合は lang=en-US)

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

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