Route Optimization API は、時間枠、車両の積載量、ドライバーの勤務時間、費用など、指定された目標と制約条件に沿って最適化を行い、車両フリートにタスクとルートを割り当てます。REST、gRPC、またはクライアント ライブラリを介して呼び出すと、訪問シーケンス、配送割り当て、推定時間、ルート指標が返されます。
Route Optimization API: 主な特長
- プロダクト: Route Optimization API
- 別名: GMPRO
- カテゴリ: ルート
- プラットフォーム: ウェブサービス(REST)
- 実行場所: サーバー(バックエンド コード)
- リリース ステージ: GA
- ライフサイクル: 有効
- 概要: Route Optimization API の概要
Route Optimization API: 使用するタイミング
Route Optimization API を使用するケース:
- 時間枠、車両の積載量、ドライバーの勤務時間、費用を考慮しながら、複数の車両に配送やタスクを割り当てる必要があります。
- 1 台の車両で複数の集荷、配達、予約を行う場合に、最適な停車順序が必要である。
injectedFirstSolutionRoutesまたはinjectedSolutionConstraintを使用して、新しい注文(オンデマンド配送など)のアクティブなルートを再最適化する必要があります。- 最適化されたプランの各区間のルートトークンを Navigation SDK に渡す必要があります。
Route Optimization API を使用すべきでない場合:
- ドライバーが計画をどのように実行しているかをリアルタイムで追跡する必要があります。この API は、リアルタイムの車両ルートではなく、計画されたポリラインを返します。代わりに Fleet Engine Service を使用してください。
- 最適化されたルートに沿ってドライバーを案内するアプリ内ターンバイターン方式ナビが必要です。代わりに Navigation SDK for Android を使用してください。
- iOS を使用するドライバー向けに、最適化されたルートに沿ったアプリ内ターンバイターン方式のガイダンスが必要です。代わりに Navigation SDK for iOS を使用してください。
Route Optimization API: 設定
- 有効にするサービス:
routeoptimization.googleapis.com - 認証: OAuth 2.0、サービス アカウント
- 使ってみる: Route Optimization API を設定する
- リファレンス: Route Optimization API リファレンス
- 料金: Route Optimization API の使用量と請求額
- ポリシー: Route Optimization API のポリシー
- リリースノート: Route Optimization API のリリースノート
公式の Route Optimization API パッケージ:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: 関連商品
- よく併用されるサービス: Navigation SDK for Android、Navigation SDK for iOS、Fleet Engine Service、Maps JavaScript API
Route Optimization API: よくある間違い
- 問題: ブロッキング
OptimizeToursエンドポイントへの REST 呼び出しの場合、デフォルトの 60 秒の期限が 60 秒を超えるリクエスト本文timeoutをオーバーライドします。修正:X-Server-Timeoutヘッダー(秒単位、接尾辞「s」なし)を設定して、期限を延長します。クライアント ライブラリと gRPC のデフォルトは 3,600 秒です。/maps/documentation/route-optimization/timeouts をご覧ください。 - 問題:
timeoutと期限の値は 1,800 秒に制限されています。修正:allowLargeDeadlineDespiteInterruptionRiskをtrueに設定して、最大 3, 600 秒を許可し、中断エラーのリスクが高くなることを受け入れます。/maps/documentation/route-optimization/timeouts をご覧ください。 - 問題: 費用パラメータ(
costPerHourやcostPerKilometerなど)がない場合、オプティマイザーはすべてのソリューションを同等に扱います。修正: ビジネス費用を反映した車両の費用パラメータを定義します。/maps/documentation/route-optimization/make-first-request をご覧ください。 - 問題: API キーで認証されたリクエストが失敗する。すべてのリクエストに OAuth トークンが必要。修正:
https://www.googleapis.com/auth/cloud-platformスコープで OAuth トークンを使用します(アプリケーションのデフォルト認証情報やサービス アカウントなど)。/maps/documentation/route-optimization/cloud-setup#create-an-oauth-token をご覧ください。
Route Optimization API でできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
- 指定されたルーティング、費用、配送、車両の制約に基づいて最適化された、複数地点に立ち寄る配送計画を返します。
- 最適化された配送計画の各停車地の開始時間と終了時間を返します。
- 最適化された配送計画の各停車地間の移動時間、遅延時間、休憩時間、待機時間を返します。
- 最適化された配送計画の各停車地での車両の積載情報を返します。
- 最適化された配送計画の各配送の費用情報を返します。
- 最適化された配送計画の各停車地間のルートのエンコードされたポリラインを返します。
- 最適化された配送計画の各経由地間のルートのナビゲーション ルート トークンを返します。
- 最適化された配送計画の配送、車両、費用の集計指標を返します。
- 複数の配送先がある配送計画の開始時間枠と終了時間枠を指定します。
- 複数地点配送計画で、各車両の開始時間と終了時間の空き状況と場所を指定します。
- 複数地点配送プランで、各車両の車両時間コストを指定します。
- 複数地点配送計画の費用モデル パラメータを指定する。
- 複数地点を経由する配送計画で、各配送の集荷時間と配達時間の制約を指定します。
- 複数地点に立ち寄る配送計画の車両割り当てを指定する。
- 複数地点配送計画で、各車両の積載量の上限を指定します。
- 複数地点を経由する配送計画で、リアルタイムの交通情報を考慮するかどうかを指定します。
- 複数地点配送計画の最適化リクエストをバッチ処理し、レスポンスを Google Cloud Storage に書き込みます。
- 配達前に駐車時間を確保する。
- 近くの訪問を優先して、連続して訪問できるようにします。
- 複数の停車地がある車両ルートで U ターンを避ける。試験運用版 注: 試験運用版の機能。pre-GA の規約と制限が適用されます。
- 事前定義された目標に合わせて最適化する。試験運用版 注: 試験運用版の機能。pre-GA の規約と制限が適用されます。
- 重い荷物を先に配達する。試験運用版 注: 試験運用版の機能。pre-GA の規約と制限が適用されます。