Gửi một OptimizeToursRequest
chứa ShipmentModel
và trả về một OptimizeToursResponse
chứa ShipmentRoute
. Đây là một tập hợp các tuyến đường sẽ được các phương tiện thực hiện để giảm thiểu tổng chi phí.
Mô hình ShipmentModel
chủ yếu bao gồm các Shipment
cần được thực hiện và các Vehicle
có thể dùng để truyền các Shipment
. Các ShipmentRoute
chỉ định các Shipment
cho Vehicle
. Cụ thể hơn, các thẻ này gán một chuỗi Visit
cho mỗi xe, trong đó Visit
tương ứng với VisitRequest
(là lượt đến lấy hàng hoặc giao hàng) của Shipment
.
Mục tiêu là cung cấp việc chỉ định ShipmentRoute
cho Vehicle
nhằm giảm thiểu tổng chi phí trong đó chi phí có nhiều thành phần được xác định trong ShipmentModel
.
Yêu cầu HTTP
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:optimizeTours
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
parent |
Bắt buộc. Nhắm mục tiêu dự án hoặc vị trí để thực hiện cuộc gọi. Định dạng: * Nếu bạn không chỉ định vị trí, hệ thống sẽ tự động chọn một khu vực. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "timeout": string, "model": { object ( |
Trường | |
---|---|
timeout |
Nếu bạn đặt thời gian chờ này, thì máy chủ sẽ trả về phản hồi trước khi hết khoảng thời gian chờ hoặc đã đến thời hạn của máy chủ đối với các yêu cầu đồng bộ, tuỳ vào thời điểm nào đến trước. Đối với các yêu cầu không đồng bộ, máy chủ sẽ tạo một giải pháp (nếu có thể) trước khi hết thời gian chờ. Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng " |
model |
Mô hình vận chuyển để giải quyết. |
solvingMode |
Theo mặc định, chế độ giải là |
searchMode |
Chế độ tìm kiếm được dùng để giải quyết yêu cầu. |
injectedFirstSolutionRoutes[] |
Hướng dẫn thuật toán tối ưu hoá cách tìm một giải pháp đầu tiên tương tự với giải pháp trước đó. Mô hình này sẽ bị hạn chế khi xây dựng giải pháp đầu tiên. Bất kỳ lô hàng nào không được thực hiện trên một tuyến sẽ được ngầm bỏ qua trong giải pháp đầu tiên, nhưng chúng có thể được thực hiện trong các giải pháp liên tiếp. Giải pháp này phải đáp ứng một số giả định cơ bản về tính hợp lệ:
Nếu giải pháp đã đưa vào không khả thi, thì không nhất thiết phải trả về lỗi xác thực và thay vào đó, hệ thống có thể trả về lỗi cho biết tính không khả thi. |
injectedSolutionConstraint |
Giới hạn thuật toán tối ưu hoá để tìm ra giải pháp cuối cùng tương tự với giải pháp trước đó. Ví dụ: chức năng này có thể được sử dụng để cố định một phần của tuyến đường đã hoàn thành hoặc đang được hoàn thành nhưng không được sửa đổi. Nếu giải pháp đã đưa vào không khả thi, thì không nhất thiết phải trả về lỗi xác thực và thay vào đó, hệ thống có thể trả về lỗi cho biết tính không khả thi. |
refreshDetailsRoutes[] |
Nếu một tuyến đường không trống, các tuyến đã cho sẽ được làm mới mà không sửa đổi trình tự lượt ghé thăm hoặc thời gian đi lại cơ bản của chúng: chỉ các thông tin chi tiết khác mới được cập nhật. Điều này không giải quyết được mô hình. Kể từ năm 2020/11, thuộc tính này chỉ điền hình nhiều đường của các tuyến không trống và yêu cầu Các trường Bạn không được sử dụng trường này cùng với
|
interpretInjectedSolutionsUsingLabels |
Nếu đúng:
Cách diễn giải này áp dụng cho các trường Nếu đúng, các nhãn trong các danh mục sau phải xuất hiện nhiều nhất một lần trong danh mục:
Nếu một Việc xoá các lượt ghé thăm tuyến đường hoặc toàn bộ tuyến đường khỏi một giải pháp được đưa vào có thể ảnh hưởng đến các hạn chế ngầm ẩn, có thể dẫn đến thay đổi trong giải pháp, lỗi xác thực hoặc tính không khả thi. LƯU Ý: Phương thức gọi phải đảm bảo rằng từng |
considerRoadTraffic |
Xem xét thông tin ước tính lưu lượng truy cập khi tính các trường |
populatePolylines |
Nếu đúng, hình nhiều đường sẽ được điền trong các |
populateTransitionPolylines |
Nếu đúng, hình nhiều đường sẽ được điền sẵn trong phản hồi |
allowLargeDeadlineDespiteInterruptionRisk |
Nếu bạn đặt chế độ này, thì yêu cầu có thể có thời hạn tối đa là 60 phút (xem https://grpc.io/blog/deadlines). Nếu không, thời hạn tối đa chỉ là 30 phút. Xin lưu ý rằng các yêu cầu dài hạn có nguy cơ bị gián đoạn lớn hơn đáng kể (nhưng vẫn nhỏ). |
useGeodesicDistances |
Nếu đúng, khoảng cách đi lại sẽ được tính bằng cách sử dụng khoảng cách trắc địa thay vì khoảng cách trên Google Maps, và thời gian di chuyển sẽ được tính bằng cách sử dụng khoảng cách trắc địa với tốc độ được xác định bằng |
label |
Nhãn có thể dùng để nhận dạng yêu cầu này, được báo cáo lại trong |
geodesicMetersPerSecond |
Khi |
maxValidationErrors |
Cắt bớt số lượng lỗi xác thực được trả về. Các lỗi này thường đi kèm với tải trọng lỗi INVALID_ARGUMENT dưới dạng chi tiết lỗi BadRequest (https://cloud.google.com/apis/design/errors#error_details), trừ khi giải resolveMode=VALIDATE_ONLY: xem trường |
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của OptimizeToursResponse
.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/cloud-platform