ガイドAPIリファレンス
ガイド

機能クラスでインシデントをフィルタリングする

道路は機能クラスによって分類されます。次の表に、道路ネットワークセグメントの機能クラスまたは機能道路クラス(FRC)の階層的分類を示します。

道路の機能クラスの値機能クラス名
1このクラスの道路は、大都市圏と都市圏を結ぶ、最高速度での大量の車両の通行を目的としています。速度の変化はあったとしても、ほとんどありません。このクラスの道路へのアクセスは通常制御されています。
2このクラスの道路は、主要道路(FRC1)への交通手段を提供し、最短時間で都市間および都市を通過するために使用されます。速度の変化はあったとしても、ほとんどありません。
3このクラスの道路は1級道路(FRC2)と相互接続し、1級道路(FRC2)よりも移動レベルは劣りますが、大量の交通車両が移動できます。
4このクラスの道路では、大量の交通車両が近隣地域間を適度な速度で移動できます。これらの道路は、上位の機能クラスの道路に接続し、近隣地域間の交通を収集および分散します。
5このクラスの道路の交通車両の量と移動レベルは、他の道路のレベルより少なくなっています。

インシデントをリクエストする場合、特定の機能クラスを持つ道路に関連するインシデント情報のみを取得するようにレスポンスをフィルタリングできます。フィルターは、1つの機能クラスまたは機能クラスのリストを参照できます。

curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/incidents?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr&functionalClasses=2,3,4"
{
   "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およびsummaryが使用する言語は、インシデントが所属する国の標準語です。

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

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

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