Method: projects.optimizeTours

string (Duration format)

如果設定了這個逾時時間，伺服器會在逾時時間到期前或同步要求的伺服器期限到期前 (以先到者為準) 傳回回應。

如果是非同步要求，伺服器會在逾時屆滿前 (如有) 產生解決方案。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。例如："3.5s"。

object (ShipmentModel)

要解決的運送模型。

enum (SolvingMode)

根據預設，解題模式為 DEFAULT_SOLVE (0)。

enum (SearchMode)

用於解決要求的搜尋模式。

object (ShipmentRoute)

引導最佳化演算法，找出與先前解決方案相似的第一個解決方案。

建構第一個解決方案時，模型會受到限制。在第一個解決方案中，凡是未在路線上執行的運送作業都會隱含略過，但可能會在後續解決方案中執行。

解決方案必須滿足一些基本的有效性假設：

• 對於所有路線，vehicleIndex 必須在範圍內，且不得重複。
• 所有造訪的 shipmentIndex 和 visitRequestIndex 都必須在範圍內。
• 一項運送資訊只能納入一條路線。
• 取貨服務配送完成後，請務必安排取貨服務配送訂單。
• 每筆訂單只能使用一種取貨或送貨替代方案。
• 所有路線的時間都會增加 (即vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime)。
• 運送作業只能在允許的車輛上執行。如果 Shipment.allowed_vehicle_indices 為空白，或其 vehicleIndex 包含在 Shipment.allowed_vehicle_indices 中，系統就會允許該車輛。

如果插入的解決方案不可行，則不一定會傳回驗證錯誤，系統可能會改為傳回不可行的錯誤。

object (InjectedSolutionConstraint)

限制最佳化演算法，找出與先前解決方案相似的最終解決方案。例如，此標記可用於凍結已完成或完成但不能修改的路徑部分。

如果插入的解決方案不可行，則不一定會傳回驗證錯誤，系統可能會改為傳回不可行的錯誤。

object (ShipmentRoute)

如果留空，系統就會重新整理指定路線，而不會修改行程的基礎造訪順序或交通時間：系統只會更新其他詳細資訊。這麼做無法解決模型問題，

自 2020 年 11 月起，這只會填入非空白路線的折線，且 populatePolylines 為 true。

傳入路徑的 routePolyline 欄位可能與路徑 transitions 不一致。

這個欄位不得與 injectedFirstSolutionRoutes 或 injectedSolutionConstraint 搭配使用。

Shipment.ignore 和 Vehicle.ignore 對行為沒有任何影響。無論是否忽略相關的貨運或車輛，所有非空白路線的造訪點之間，仍會填入折線。

boolean

如果為 true：

• 使用 ShipmentRoute.vehicle_label 而非 vehicleIndex，比對已插入解決方案中的路線與要求中的車輛；如果非空白，則重複使用原始 ShipmentRoute.vehicle_index 與新 ShipmentRoute.vehicle_index 的對應項目，以更新 ConstraintRelaxation.vehicle_indices，但對應項目必須明確無誤 (也就是說，多個 ShipmentRoute 不得共用相同的原始 vehicleIndex)。
• 使用 ShipmentRoute.Visit.shipment_label 而非 shipmentIndex，將插入的解決方案中的造訪與要求中的出貨進行比對。
• 使用 SkippedShipment.label (而不是 SkippedShipment.index) 來比對插入解決方案中略過的出貨及要求出貨要求。

這項解釋適用於 injectedFirstSolutionRoutes、injectedSolutionConstraint 和 refreshDetailsRoutes 欄位。如果要求中的運送或車輛索引在解決方案建立後有所變更，可以使用這項屬性，可能是因為運輸或車輛從要求中移除或新增至要求中。

如為 true，下列類別中的標籤最多只能出現一次：

• 要求中的 Vehicle.label；
• 要求中的 Shipment.label；
• 插入的解決方案中有 ShipmentRoute.vehicle_label；
• 插入的解決方案中的 SkippedShipment.label 和 ShipmentRoute.Visit.shipment_label (除了接送/送達訪問次組合，其 shipmentLabel 必須出現兩次)。

如果插入解決方案中的 vehicleLabel 與要求車輛不相符，系統會將對應的路線和造訪資料從解決方案中移除。如果插入解決方案中的 shipmentLabel 不符合要求運送要求，系統會將相應的造訪動作從解決方案中移除。如果注入的解決方案中的 SkippedShipment.label 與要求的傳送作業不符，系統會從解決方案中移除 SkippedShipment。

從已插入的解決方案中移除路徑瀏覽或整個路徑，可能會影響隱含限制，進而導致解決方案變更、驗證錯誤或無法執行。

注意：呼叫端必須確保每個 Vehicle.label (resp. Shipment.label) 會在兩個相關要求中，明確指出所使用的車輛 (或相應的出貨) 實體：產生用於注入解決方案的 OptimizeToursResponse 的過去要求，以及包含注入解決方案的目前要求。上述獨特性檢查不足以保證這項規定。

boolean

在計算 ShipmentRoute 欄位 Transition.travel_duration、Visit.start_time 和 vehicleEndTime、設定 ShipmentRoute.has_traffic_infeasibilities 欄位，以及計算 OptimizeToursResponse.total_cost 欄位時，請考慮使用流量估算值。

boolean

如果為 true，回應 ShipmentRoute 會填入多邊形。

boolean

如果為 true，系統會在回應 ShipmentRoute.transitions 中填入折線和路線符記。

boolean

如果設定了這個值，要求的期限 (請參閱 https://grpc.io/blog/deadlines) 最多可達 60 分鐘。否則，最長期限為 30 分鐘。請注意，長時間存在的要求有較高 (但仍很低) 的中斷風險。

boolean

如果為 true，系統會使用大地測量距離 (而非 Google 地圖距離) 計算行程距離，並使用大地測量距離和 geodesicMetersPerSecond 定義的速度計算行程時間。

string

可能用於識別此要求的標籤，會回報至 OptimizeToursResponse.request_label。

number

當 useGeodesicDistances 為 true 時，必須設定這個欄位，並定義用於計算行程時間的速度。這個值必須至少為 1.0 公尺/秒。

integer

截斷傳回的驗證錯誤數量。這些錯誤通常會以 BadRequest 錯誤詳細資料的形式附加至 INVALID_src 錯誤酬載 (https://cloud.google.com/apis/design/errors#error_details)，除非 ResolutionMode=VALIDATE_ONLY：請參閱 OptimizeToursResponse.validation_errors 欄位。預設值為 100，上限為 10,000。