HERE Matrix Routing API v8のトラフィック

ルーティングマトリックスの計算では、交通情報を考慮できます。これは、計算されたマトリックスの距離/travel時間に影響を与える可能性があります。

交通情報は時間に依存します。次のいずれかを選択できます。

• トラフィックの現在の状態 (ライブ)
• 過去のトラフィックデータ

先行ルートを計画する場合、または過去のルートを計算する場合は、トラフィックの時間を指定する必要があります。

すべての出発地点からの出発時間として指定できるのは1つの出発地点のみです。この出発時間はその後、すべてのルート計算に適用されます。

サービスは適用する交通情報を自動的に決定します。将来の出発時間については、出発時間の将来の長さに応じて、ライブまたは履歴のトラフィックデータが適用されます。

過去の出発時間には、過去のトラフィックデータのみが適用されます。出発時間にかかわらず、長期道路閉鎖が常に適用されます (プロファイルモードでは適用されることがないため除く)。

交通情報はcarとtruckのモードにのみ関連し、pedestrianとbicycleのモードでのマトリックス計算では交通情報は使用されません。

出発時間

トラフィックの時間は、マトリックスリクエストのdepartureTimeフィールドによって決まります。指定できる値は次のとおりです。

• 省略またはnullを指定：サービスは現在の時刻の交通情報を使用します。
• ISO8601の日時 (明示的なタイムゾーン付き)：サービスは指定された時間に利用可能な交通情報を使用します。
• any：サービスは長期道路閉鎖以外の交通情報を使用しません。

例

次の例は、明示的な出発時間を持つルーティングマトリックスのリクエストを示しています。

{
    "origins": [
        {"lat": 52.52103, "lng": 13.41268},
        {"lat": 52.51628, "lng": 13.37771},
        {"lat": 52.47342, "lng": 13.40357}
    ],
    "regionDefinition": {
        "type": "boundingBox",
        "north": 52.53,
        "south": 52.46,
        "west": 13.35,
        "east": 13.42
    },
    "departureTime": "2018-12-19T18:23:45+01:00"
}