Method: projects.locations.optimizeTours

ShipmentModel を含む OptimizeToursRequest を送信し、さらに ShipmentRoute を含む OptimizeToursResponse を返します。この一連のルートは、全体的なコストを最小化するために車両が実行します。

ShipmentModel モデルは主に、実行が必要な Shipment と、Shipment の転送に使用できる Vehicle で構成されています。ShipmentRouteShipmentVehicle に割り当てます。具体的には、各車両に一連の Visit を割り当てます。VisitVisitRequest に対応し、Shipment の集荷または配達を表します。

目的は、費用に ShipmentModel で定義された多くのコンポーネントがある場合に総費用を最小限に抑えるために、ShipmentRouteVehicle に割り当てることです。

HTTP リクエスト

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:optimizeTours

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。呼び出しを行うターゲット プロジェクトまたはロケーション。

形式: * projects/{project-id} * projects/{project-id}/locations/{location-id}

ロケーションが指定されていない場合、リージョンは自動的に選択されます。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "timeout": string,
  "model": {
    object (ShipmentModel)
  },
  "solvingMode": enum (SolvingMode),
  "searchMode": enum (SearchMode),
  "injectedFirstSolutionRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "injectedSolutionConstraint": {
    object (InjectedSolutionConstraint)
  },
  "refreshDetailsRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "interpretInjectedSolutionsUsingLabels": boolean,
  "considerRoadTraffic": boolean,
  "populatePolylines": boolean,
  "populateTransitionPolylines": boolean,
  "allowLargeDeadlineDespiteInterruptionRisk": boolean,
  "useGeodesicDistances": boolean,
  "label": string,
  "geodesicMetersPerSecond": number,
  "maxValidationErrors": integer
}
フィールド
timeout

string (Duration format)

このタイムアウトが設定されている場合、サーバーは、タイムアウト期間か同期リクエストのサーバー期限のどちらか早いほうでレスポンスを返します。

非同期リクエストの場合は、タイムアウト時間が経過する前にサーバーがソリューションを生成します(可能な場合)。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

model

object (ShipmentModel)

解決する配送モデル。

solvingMode

enum (SolvingMode)

デフォルトの解決モードは DEFAULT_SOLVE(0)です。

searchMode

enum (SearchMode)

リクエストの解決に使用された検索モード。

injectedFirstSolutionRoutes[]

object (ShipmentRoute)

最適化アルゴリズムをガイドして、前の解に似た最初の解を見つけます。

最初のソリューションを構築する際には、モデルに制約が課されます。あるルートで実施されなかった配送は、最初のソリューションでは暗黙的にスキップされますが、連続したソリューションでは実施される可能性があります。

このソリューションは、次のような基本的な妥当性の前提を満たしている必要があります。

  • すべてのルートで、vehicleIndex は範囲内にあり、重複しないようにする必要があります。
  • すべての訪問で、shipmentIndexvisitRequestIndex が範囲内である必要があります。
  • 配送は 1 つのルートでのみ参照できます。
  • 集荷配送の集荷は、配送の前に行う必要があります。
  • 1 つの配送について、複数の受け取りまたは配送の代替を行うことはできない。
  • すべてのルートで所要時間が増加(vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime)。
  • 配送は、許可されている車両でのみ行うことができます。Shipment.allowed_vehicle_indices が空であるか、車両の vehicleIndexShipment.allowed_vehicle_indices に含まれている場合、車両は許可されます。

挿入された解が実行不可能な場合、必ずしも検証エラーが返されるとは限らず、代わりに実行可能性を示すエラーが返されることがあります。

injectedSolutionConstraint

object (InjectedSolutionConstraint)

最適化アルゴリズムを制約して、前の解に似た最終的な解を見つけます。たとえば、すでに完了しているルートや、もう完了するが変更してはならないルートの一部を凍結するために使用できます。

挿入された解が実行不可能な場合、必ずしも検証エラーが返されるとは限らず、代わりに実行可能性を示すエラーが返されることがあります。

refreshDetailsRoutes[]

object (ShipmentRoute)

空でない場合、指定された経路は更新され、訪問や移動時間の基礎となる順序は変更されず、他の詳細情報のみが更新されます。これではモデルは解決されません。

2020/11 の時点では、空でないルートのポリラインにのみデータが入力され、populatePolylines が true である必要があります。

渡されたルートの routePolyline フィールドがルート transitions と一致しない可能性があります。

このフィールドは、injectedFirstSolutionRoutes または injectedSolutionConstraint と併用しないでください。

Shipment.ignoreVehicle.ignore は動作に影響しません。関連する配送または車両が無視されるかどうかにかかわらず、空ではないすべてのルートのすべての訪問の間にポリラインが入力されます。

interpretInjectedSolutionsUsingLabels

boolean

true の場合:

この解釈は、injectedFirstSolutionRoutesinjectedSolutionConstraintrefreshDetailsRoutes フィールドに適用されます。ソリューションの作成後にリクエストの出荷数または車両のインデックスが変更された場合に使用できます。たとえば、出荷または車両がリクエストから削除または追加された場合などです。

true の場合、次のカテゴリのラベルはそのカテゴリ内に最大 1 回出現する必要があります。

挿入されたソリューションの vehicleLabel がリクエストの車両に対応していない場合、対応するルートは訪問とともにソリューションから削除されます。挿入されたソリューションの shipmentLabel が配送リクエストの対応でない場合、対応する訪問はソリューションから削除されます。挿入されたソリューションの SkippedShipment.label がリクエストされた配送に一致しない場合、SkippedShipment はソリューションから削除されます。

挿入されたソリューションからルート訪問またはルート全体を削除すると、暗黙の制約に影響を与える可能性があり、ソリューションの変更、検証エラー、実現不能につながる可能性があります。

注: 呼び出し元は、各 Vehicle.label(resp.Shipment.label など)は、2 つの関連リクエスト(挿入されたソリューションで使用される OptimizeToursResponse を生成した過去のリクエストと、挿入されたソリューションを含む現在のリクエスト)で使用される車両(応答配送)エンティティを一意に識別します。上記の一意性チェックは、この要件を保証するには不十分です。

considerRoadTraffic

boolean

ShipmentRoute フィールドの Transition.travel_durationVisit.start_timevehicleEndTime の計算では、トラフィックの見積もりを考慮します。ShipmentRoute.has_traffic_infeasibilities フィールドの設定と OptimizeToursResponse.total_cost フィールドの計算における。

populatePolylines

boolean

true の場合、ポリラインはレスポンスの ShipmentRoute で入力されます。

populateTransitionPolylines

boolean

true の場合、レスポンス ShipmentRoute.transitions にポリラインが入力されます。

allowLargeDeadlineDespiteInterruptionRisk

boolean

これが設定されている場合、リクエストに最大 60 分の期限(https://grpc.io/blog/deadlines を参照)を設定できます。それ以外の場合、最大期限は 30 分です。実行時間が長いリクエストは、中断のリスクが大幅に高くなります(ただし、それでもわずかです)。

useGeodesicDistances

boolean

true の場合、移動距離は Google マップの距離ではなく測地線距離を使用して計算され、移動時間は geodesicMetersPerSecond で定義される速度の測地線距離を使用して計算されます。

label

string

このリクエストの識別に使用できるラベル。OptimizeToursResponse.request_label で報告されます。

geodesicMetersPerSecond

number

useGeodesicDistances が true の場合、このフィールドを設定し、移動時間の計算に適用される速度を定義する必要があります。値は 1.0 メートル/秒以上である必要があります。

maxValidationErrors

integer

返された検証エラーの数を切り捨てます。通常、これらのエラーは、solvingMode=VALIDATE_ONLY の場合を除き、INVALID_ARGUMENT エラー ペイロードに BadRequest エラーの詳細(https://cloud.google.com/apis/design/errors#error_details)としてアタッチされます。OptimizeToursResponse.validation_errors フィールドをご覧ください。デフォルトは 100 で、上限は 10,000 です。

レスポンスの本文

成功した場合、レスポンスの本文には OptimizeToursResponse のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

IAM 権限

parent リソースに対する次の IAM 権限が必要です。

  • routeoptimization.locations.use

詳細については、IAM のドキュメントをご覧ください。