APIの変更

以下のセクションでは、追加、変更、削除されたAPIを示しています。

2025-05-16に追加

インシデントタイプの翻訳をサポートするために、インシデント対応にtypeDescriptionフィールドを追加しました。

例：

{
    "criticality": "minor",
    "type":"disabledVehicle",
    "typeDescription": {
        "value": "Liegengebliebenes Fahrzeug",
        "language": "de-DE"
    },
    "codes":[735],
    "description": {
        "value":"Wegen Baustelle gesperrt",
        "language":"de-DE"
    },
    "summary": {
        "value":"Wegen Baustelle gesperrt",
        "language":"de-DE"
    },
    "junctionTraversability": "intermediateClosedEdgeOpen"
}

サポートされている言語の場合、typeDescriptionフィールドにインシデントタイプ値のローカライズされた説明があります。

2024-01-11に追加

POSTメソッドを使用して、すべてのパラメーターをJSONデータとして渡せるようになりました。

POSTペイロードの例：

{
    "in": {
        "type": "bbox",
        "west": 13.386969,
        "south": 52.527129,
        "east": 13.424134,
        "north": 52.549420
    },
    "locationReferencing": [
        "olr"
    ],
    "functionalClasses": [
        4,
        5
    ],
    "criticality": [
        "critical",
        "major",
        "minor"
    ],
    "type": ["construction"],
    "earliestStartTime": 1637730069,
    "latestEndTime": 1704783973,
    "lang": "DE",
    "units": "metric"
}

この新しい方法により、APIリクエストがURIの長さ制限 (1,000文字) より長い値を持つことがある状況を回避できるようになります。これはトポロジーセグメント参照によるリクエストで多く発生していました。

2022-05-19に変更

/incidents/{originalId}エンドポイントの前に名前空間を付けることができるようになりました。名前空間が指定されていない場合、デフォルトではhere:traffic:incidentであると見なされます。

次のどちらのバリエーションも使用できます。

here:traffic:incident:3879526487457467809
3879526487457467809

また、レスポンスJSONにはidとoriginal_idの両方のHRN表記が含まれるようになりました。

例：

"incidentDetails": {
    "id": "3848418285967206000",
    "hrn": "here:traffic:incident:3848418285967206000",
    "originalId": "2349753562597427700",
    "originalHrn": "here:traffic:incident:2349753562597427700",
    "roadClosed": true