Route Handle

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

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

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

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

有効期限

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

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

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

パラメーター

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

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

EV パラメータ

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

  • makeReachable,
  • preferredBrands

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

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