ルートハンドル

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

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

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

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

有効期限

ルートハンドルは、基盤となるマップ データに密に結合されたパスをエンコードします。 既存のハンドルを無効化できるシナリオは、およそ 3 つあります。

  1. エンコードおよびデコードの方法が変更され、新しいリリースの既存のすべてのハンドルが無効になります。 この問題はほとんど発生しません。
  2. マップ データのトポロジが変更され、影響を受けるすべてのハンドルが無効になります。 これらは、高速道路の出口の追加や削除などの現実世界での変更、または道路が複数のデジタル化された道路に分割されるなどの仮想的な変更になります。 パス上に変更されたセグメントを含むすべてのハンドルが無効化されます。 道路が区間の始点 / 終点で追加 / 削除された場合も、その道路がそのルートで使用されていない場合でも、区間が変更されたと見なされます。 トポロジの変更はほとんど発生しませんが、ルートの長さが長くなると、トポロジの変更が発生する可能性が高くなります。
  3. 電気自動車のルートを計算する場合、チャージステーションの更新または削除を行うと、これらのチャージステーションを使用するすべてのハンドルが無効になります。

これらの変更の頻度にかかわらず、一部またはすべてのルートハンドルが無効になるため、ユーザは常に障害に対処できるように準備する必要があります。 これらの失敗を処理する簡単な手順は、新しい(有効な)ルートハンドルを取得するためにルートを再計算することです。

パラメーター

ルートの計算に使用されるパラメータはルートハンドルにエンコードさ routeHandleれないため、を使用してルートを再作成する場合は、これらのパラメータを再度指定する必要があります。

たとえば transportMode 、このパラメータは、ルート計算に以前使用されていた転送モードと一致する必要はありません。 ただし、別の輸送モードを使用している場合、例えば、提供された輸送モードでは道路セグメントがルートに含まれていない場合、要求が失敗することがあります。

EV パラメータ

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

  • makeReachable,
  • preferredBrands

」に一致する結果は 件です

    」に一致する結果はありません