Route Optimization API クイック リファレンス

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: 設定

公式の 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: よくある間違い

  • 問題: ブロッキング 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 でできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。