ルートハンドルの概要

ルートハンドルは以前に計算されたルートからパスをエンコードします。短時間でルートをコンパクトにキャッシュに保存するために使用できます。したがって、これを使用すると、ルート上のより多くのデータを取得し、更新されたトラフィック情報を入手できます。

ただし、ルートデータ自体は保存されません。つまり、まったく同じトラフィックデータを取得するために使用することはできません。

ルートハンドルAPIのサンプルリクエストについては、次のチュートリアルを参照してください。

• ルートハンドルの使用方法
• さまざまなオプションでルートを再評価する

originパラメーターを使用して更新されたルートおよびルートハンドルを取得する方法を示すコードサンプルについては、次のチュートリアルを参照してください。

• 現在のルートを更新する
• 逸脱後に現在のルートを調整する

有効性

ルート ハンドルは基盤となるマップ データに密に結合されたパスをエンコードします。既存のハンドルを無効化できるユースケースは大まかに 3 つあります。

1. エンコード方法やデコード方法が変更され、新しいリリースで既存のハンドルがすべて無効になる。これが発生することはほとんどありません。
2. マップ データのトポロジーが変更され、影響を受けるすべてのハンドルが無効になる。ハイウェイ出口が追加または削除されるなどの実世界での変更や、道路がマルチデジタル化された道路に分割されるなどの仮想的な変更が当てはまります。パス上にある、変更されたセグメントを含むすべてのハンドルが無効になります。セグメントの先頭または末尾に道路が追加、削除された場合、その道路がルートで使用されていなくても、そのセグメントは変更されたものと見なされます。トポロジーの変更はめったに発生しませんが、ルートが長くなると発生する可能性が高くなります。
3. 電気自動車のルートを計算するとき、充電スタンドを更新または削除すると、これらの充電スタンドを使用しているすべてのハンドルが無効になります。

これらの変更が一部またはすべてのルート ハンドルを無効にする頻度に関係なく、ユーザーは常に失敗に対処できるように準備しなければなりません。これらの失敗を処理する簡単な手順は、ルートを再計算して新しい (有効な) ルート ハンドルを取得することです。

パラメーター

ルートの計算に使用されるパラメーターはルートハンドルでエンコードされていないため、routeHandleを使用してルートを再作成するときに再度指定してください。

たとえば、transportModeパラメーターは、以前にルート計算に使用した移動モードと一致する必要はありません。ただし、別の移動モードを使用すると、指定した移動モードで禁止されている道路区間がルートにあるという理由で、リクエストが失敗することがあります。

EVパラメーター

ルート ハンドル エンドポイントは、ルートの計算に使用されるすべての電気自動車 (EV) パラメーターをサポートします。ただし、次のものを除きます。

• makeReachable、
• preferredBrands、
• preferredChargePointOperators、
• excludeChargePointOperators、
• excludeChargingStations。