Danh sách tham số

Trang sau đây chứa các bảng tham số theo thứ tự bảng chữ cái cho các thành phần sau đây của phương thức optimizeTours trong API Tối ưu hoá tuyến đường:

Các bảng tham số này chỉ liệt kê và mô tả ngắn gọn các đối tượng cấp cao nhất và tham số chính để dễ dàng khám phá. Để biết danh sách đầy đủ kèm theo nội dung mô tả hoàn chỉnh và tất cả các tham số lồng nhau, hãy xem tài liệu tham khảo API.

Nội dung yêu cầu

Cấu trúc dữ liệu của nội dung yêu cầu.

Nội dung yêu cầu bao gồm các phần tử sau đây, được minh hoạ trong biểu đồ ở bên phải và được liệt kê trong bảng bên dưới:

  • OptimizeToursRequest: Đối tượng yêu cầu cấp cao nhất chứa mô hình và các tham số giải quyết.
    • ShipmentModel: Cấu trúc dữ liệu cốt lõi chứa các lô hàng, xe và các ràng buộc chung.
      • Shipment: Một việc cần làm có hoạt động đến lấy hàng và giao hàng.
        • VisitRequest: Vị trí và các ràng buộc đối với việc đến lấy hàng hoặc giao hàng.
      • Vehicle: Xe có thể thực hiện việc vận chuyển.
Cha mẹ Tham số Loại khách sạn Mô tả
OptimizeToursRequest allowLargeDeadlineDespiteInterruptionRisk boolean (true/false) Nếu true, yêu cầu sẽ được xử lý ngay cả khi thời gian chờ được đặt thành một giá trị lớn (dài hơn 30 phút) có nguy cơ gây ra tình trạng gián đoạn máy chủ.
considerRoadTraffic boolean (true/false) Nếu true, hãy sử dụng dữ liệu giao thông để định tuyến. Nếu là false, chỉ sử dụng tốc độ mạng lưới đường bộ.
geodesicMetersPerSecond số Khi useGeodesicDistances là true, tốc độ này được dùng để tính thời gian di chuyển.
injectedFirstSolutionRoutes[] mảng đối tượng (ShipmentRoute) Các tuyến đường từ giải pháp trước đó để bắt đầu tối ưu hoá.
injectedSolutionConstraint đối tượng (InjectedSolutionConstraint) Hạn chế giải pháp tương tự như các tuyến đường hiện có, chỉ định những thuộc tính phải được giữ nguyên và những thuộc tính có thể được nới lỏng.
interpretInjectedSolutionsUsingLabels boolean (true/false) Nếu true, hãy so khớp các lô hàng/xe trong các tuyến đường được chèn theo label thay vì chỉ mục mảng.
label chuỗi Nhãn tuỳ ý để xác định yêu cầu, được trả về trong phản hồi.
maxValidationErrors số nguyên Chỉ định số lượng lỗi xác thực tối đa cần trả về. Nếu bạn không chỉ định, hệ thống sẽ áp dụng một hạn mức mặc định.
model đối tượng (ShipmentModel) Bắt buộc. Tập hợp các phương tiện và lô hàng cần được tối ưu hoá.
populatePolylines boolean (true/false) Nếu true, trả về nhiều đường mã hoá cho các tuyến đường.
populateTransitionPolylines boolean (true/false) Nếu true, trả về đường nhiều đoạn được mã hoá cho từng lượt chuyển đổi giữa các lượt truy cập.
refreshDetailsRoutes[] mảng đối tượng (ShipmentRoute) Danh sách các tuyến đường cần làm mới. Thao tác này sẽ tính toán lại các đường nhiều đoạn, thời lượng và khoảng cách cho các tuyến đường hiện có mà không sửa đổi trình tự ghé thăm.
searchMode enum (SearchMode) RETURN_FAST (kết quả nhanh) hoặc CONSUME_ALL_AVAILABLE_TIME (chất lượng tốt nhất trong thời gian chờ).
solvingMode enum (SolvingMode) DEFAULT_SOLVE (mặc định) hoặc VALIDATE_ONLY để xác thực mô hình mà không cần giải.
timeout Thời lượng Thời lượng tối đa mà trình giải quyết nên chạy (ví dụ: "30s", "300s").
useGeodesicDistances boolean (true/false) Nếu true, khoảng cách và thời gian di chuyển được tính bằng khoảng cách trắc địa (đường thẳng) và tốc độ geodesicMetersPerSecond.
ShipmentModel
(Một phần của OptimizeToursRequest)		 durationDistanceMatrices[] mảng đối tượng (DurationDistanceMatrix) Chỉ định ma trận khoảng cách và thời lượng tuỳ chỉnh được dùng để định tuyến giữa các vị trí.
durationDistanceMatrixDstTags[] mảng chuỗi Thẻ xác định đích đến (cột) cho ma trận khoảng cách và thời lượng tuỳ chỉnh.
durationDistanceMatrixSrcTags[] mảng chuỗi Thẻ xác định các nguồn (hàng) cho ma trận khoảng cách và thời lượng tuỳ chỉnh.
globalDurationCostPerHour số Chi phí mỗi giờ trong khoảng thời gian toàn cầu của tuyến đường, từ thời điểm bắt đầu sớm nhất của xe đến thời điểm kết thúc muộn nhất của xe.
globalEndTime Dấu thời gian Thời gian kết thúc muộn nhất cho mọi sự kiện trong mô hình.
globalStartTime Dấu thời gian Thời gian bắt đầu sớm nhất cho mọi sự kiện trong mô hình.
maxActiveVehicles số nguyên Số lượng xe tối đa được phép hoạt động trong giải pháp.
precedenceRules[] mảng đối tượng (PrecedenceRule) Các quy tắc xác định các quy tắc ràng buộc về thứ tự giữa các lô hàng cụ thể.
shipments[] mảng đối tượng (Shipment) Danh sách các lô hàng cần được phục vụ.
shipmentTypeIncompatibilities[] mảng đối tượng (ShipmentTypeIncompatibility) Các quy tắc ngăn việc vận chuyển một số loại hàng hoá nhất định bằng cùng một xe.
shipmentTypeRequirements[] mảng đối tượng (ShipmentTypeRequirement) Quy tắc yêu cầu cùng một xe vận chuyển các lô hàng thuộc một số loại nhất định.
transitionAttributes[] mảng đối tượng (TransitionAttributes) Chỉ định chi phí bổ sung, độ trễ và giới hạn khoảng cách cho các lượt chuyển đổi giữa các lượt truy cập có thẻ cụ thể.
vehicles[] mảng đối tượng (Vehicle) Danh sách các phương tiện có thể thực hiện chuyến vận chuyển.
Shipment
(Một phần của ShipmentModel)		 allowedVehicleIndices[] mảng số nguyên Chỉ số của những chiếc xe được phép thực hiện chuyến vận chuyển này.
costsPerVehicle[] map (key: integer, value: number) Chi phí phát sinh thêm nếu một chiếc xe cụ thể vận chuyển lô hàng này.
costsPerVehicleIndices[] mảng số nguyên Chỉ mục của những chiếc xe mà giá trị costsPerVehicle áp dụng.
deliveries[] mảng đối tượng (VisitRequest) Các lựa chọn thay thế để giao lô hàng.
ignore boolean (true/false) Nếu là true, thì lô hàng sẽ bị bỏ qua và không được dùng để tối ưu hoá.
label chuỗi Nhãn do người dùng xác định để xác định lô hàng, được trả về trong phản hồi.
loadDemands map (key: string, value: Load) Dung lượng cần thiết (ví dụ: trọng lượng, thể tích) để vận chuyển lô hàng này.
penaltyCost số Chi phí nếu lô hàng không được giao. Nếu bạn không đặt, thì lô hàng là bắt buộc.
pickups[] mảng đối tượng (VisitRequest) Các lựa chọn thay thế để nhận lô hàng.
pickupToDeliveryAbsoluteDetourLimit Thời lượng Thời gian đi đường vòng tối đa được phép giữa thời gian đến lấy và thời gian giao hàng so với đường đi trực tiếp.
pickupToDeliveryRelativeDetourLimit số Đường vòng tối đa cho phép đối với lô hàng (ví dụ: giá trị 2.0 có nghĩa là tổng thời gian có thể tối đa gấp 2 lần thời gian di chuyển trực tiếp).
pickupToDeliveryTimeLimit Thời lượng Thời gian tối đa được phép từ khi bắt đầu đến lấy đến khi bắt đầu giao hàng.
shipmentType chuỗi Phân loại loại được dùng cho các quy tắc về khả năng không tương thích và yêu cầu.
VisitRequest
(Một thành phần của pickups và deliveries trong Shipment)		 arrivalLocation đối tượng (LatLng) Vị trí đến theo địa lý dưới dạng toạ độ vĩ độ/kinh độ.
arrivalWaypoint đối tượng (Waypoint) Vị trí mà xe đến để thực hiện chuyến ghé thăm. Được xác định bằng toạ độ hoặc mã địa điểm.
cost số Chi phí phát sinh nếu người giải quyết chọn yêu cầu ghé thăm cụ thể này.
departureLocation đối tượng (LatLng) Vị trí khởi hành theo toạ độ vĩ độ/kinh độ.
departureWaypoint đối tượng (Waypoint) Vị trí mà xe rời đi sau khi hoàn tất chuyến ghé thăm. Nếu bạn bỏ qua, giá trị này được giả định là giống với arrivalWaypoint.
duration Thời lượng Thời lượng của chuyến thăm (thời gian dịch vụ), ví dụ: thời gian cần thiết để tải/dỡ hàng.
label chuỗi Nhãn do người dùng xác định cho yêu cầu truy cập cụ thể này, được trả về trong phản hồi.
loadDemands map (key: string, value: Load) Yêu cầu chỉ định mức thay đổi tải trong lượt truy cập này (ví dụ: -1 để thả gói hàng).
tags[] mảng chuỗi Các thẻ được đính kèm vào yêu cầu truy cập này. Các giá trị này được dùng để tính thời gian di chuyển giữa lượt truy cập này và các lượt truy cập khác bằng transitionAttributes.
timeWindows[] mảng đối tượng (TimeWindow) Khung thời gian được phép đến trong lượt ghé thăm này.
visitTypes[] mảng chuỗi Các chuỗi mô tả loại lượt truy cập (ví dụ: "delivery", "installation"). Được dùng để áp dụng extraVisitDurationForVisitType từ Mẫu xe.
Vehicle
(Một phần của ShipmentModel)		 breakRule đối tượng (BreakRule) Xác định các quy tắc cho thời gian nghỉ (ví dụ: thời gian nghỉ trưa bắt buộc).
costPerHour số Chi phí trên mỗi giờ của tổng thời lượng tuyến đường.
costPerKilometer số Chi phí cho mỗi km đã đi.
costPerTraveledHour số Chi phí mỗi giờ khi xe đang di chuyển.
endLocation đối tượng (LatLng) Vị trí địa lý cuối cùng dưới dạng toạ độ vĩ độ/kinh độ.
endTags[] mảng chuỗi Các thẻ xác định trạng thái cuối của xe, dùng cho các thuộc tính chuyển đổi.
endTimeWindows[] mảng đối tượng (TimeWindow) Khoảng thời gian được phép để xe kết thúc lộ trình.
endWaypoint đối tượng (Waypoint) Vị trí kết thúc địa lý bằng cách sử dụng Điểm tham chiếu (toạ độ hoặc mã địa điểm).
extraVisitDurationForVisitType map (key: string, value: Duration) Thêm thời lượng cho các lượt ghé thăm dựa trên visitType.
fixedCost số Chi phí cố định được áp dụng nếu xe được sử dụng, bất kể khoảng cách hoặc thời lượng của tuyến đường.
ignore boolean (true/false) Nếu true, xe sẽ bị bỏ qua và không được dùng để tối ưu hoá.
label chuỗi Nhãn do người dùng xác định cho xe, được trả về trong phản hồi.
loadLimits map (key: string, value: LoadLimit) Sức chứa của xe (ví dụ: trọng lượng tối đa, thể tích tối đa).
routeDistanceLimit đối tượng (DistanceLimit) Giới hạn cứng hoặc giới hạn mềm đối với tổng quãng đường của tuyến đường mà xe đi.
routeDurationLimit đối tượng (DurationLimit) Giới hạn cứng hoặc giới hạn mềm về tổng thời lượng của tuyến đường mà xe đi.
routeModifiers đối tượng (RouteModifiers) Một hoặc nhiều điều kiện hạn chế, chẳng hạn như tránh trạm thu phí, đường cao tốc hoặc phà.
startLocation đối tượng (LatLng) Vị trí bắt đầu trên bản đồ dưới dạng toạ độ vĩ độ/kinh độ.
startTags[] mảng chuỗi Các thẻ xác định trạng thái ban đầu của xe, dùng cho các thuộc tính chuyển đổi.
startTimeWindows[] mảng đối tượng (TimeWindow) Khoảng thời gian cho phép để xe bắt đầu hành trình.
startWaypoint đối tượng (Waypoint) Vị trí bắt đầu trên bản đồ bằng cách sử dụng một Điểm tham chiếu (toạ độ hoặc mã địa điểm).
travelDurationLimit đối tượng (DurationLimit) Giới hạn cứng hoặc giới hạn mềm về tổng thời gian di chuyển (không bao gồm thời gian chờ/thời gian phục vụ) của xe.
travelDurationMultiple số Hệ số được áp dụng cho thời gian di chuyển (ví dụ: 1,5 làm cho thời gian di chuyển chậm hơn 50%).
travelMode enum (TravelMode) Phương tiện đi lại (ví dụ: DRIVING, WALKING). Ảnh hưởng đến thời gian và khoảng cách di chuyển.
unloadingPolicy enum (UnloadingPolicy) Xác định thứ tự dỡ hàng (ví dụ: LIFO hoặc LAST_IN_FIRST_OUT).
usedIfRouteIsEmpty boolean (true/false) Nếu true, thì xe được coi là xe đã qua sử dụng ngay cả khi không có lô hàng. Tuyến đường này có chi phí cố định và di chuyển giữa vị trí bắt đầu và vị trí kết thúc.

Nội dung phản hồi

Cấu trúc dữ liệu của nội dung phản hồi.

Nội dung phản hồi bao gồm các phần tử sau đây, được minh hoạ trong sơ đồ ở bên phải và được liệt kê trong bảng bên dưới:

  • OptimizeToursResponse: Đối tượng phản hồi cấp cao nhất chứa các tuyến đường và chỉ số được tối ưu hoá.
    • Metrics: Chi phí tổng thể và số liệu thống kê về việc thực thi cho giải pháp.
    • ShipmentRoute: Trình tự các lượt ghé thăm và đường đi được chỉ định cho một chiếc xe.
      • Visit: Một điểm dừng trên tuyến đường để thực hiện việc lấy hàng hoặc giao hàng.
      • Transition: Đường đi và thời gian di chuyển giữa 2 điểm dừng trên tuyến đường.
      • AggregatedMetrics: Tổng thời lượng, quãng đường và các chỉ số khác. Phần tử này có thể xuất hiện cả trong Metrics và ShipmentRoute.
Cha mẹ Tham số Loại khách sạn Mô tả
OptimizeToursResponse metrics đối tượng (Metrics) Các chỉ số tổng hợp cho giải pháp, bao gồm tổng chi phí, tổng quãng đường, tổng thời gian và số lượt sử dụng xe.
requestLabel chuỗi Nhãn được sao chép từ trường label của yêu cầu. Dùng để liên kết phản hồi với yêu cầu ban đầu.
routes[] mảng đối tượng (ShipmentRoute) Danh sách các tuyến đường được tính toán cho từng xe. Chứa một mục nhập cho mỗi phương tiện, bất kể mức sử dụng.
skippedShipments[] mảng đối tượng (SkippedShipment) Danh sách các lô hàng bị bỏ qua (không được xử lý), cùng với lý do khiến các lô hàng đó bị bỏ qua.
validationErrors[] mảng đối tượng (OptimizeToursValidationError) Danh sách các lỗi xác thực được tìm thấy trong mô hình đầu vào. Trường này được điền sẵn nếu solvingMode được đặt thành VALIDATE_ONLY hoặc nếu xảy ra lỗi trong quá trình giải quyết.
Metrics
(Một phần của OptimizeToursResponse)		 aggregatedRouteMetrics đối tượng (AggregatedMetrics) Số liệu thống kê tổng hợp trên tất cả các tuyến đường, chẳng hạn như tổng quãng đường di chuyển, tổng thời gian và thời gian chờ.
costs map (key: string, value: number) Bảng chi tiết về chi phí theo loại (ví dụ: "model.vehicles.cost_per_kilometer", "model.shipments.penalty_cost").
earliestVehicleStartTime Dấu thời gian Thời gian bắt đầu sớm nhất trong số tất cả các xe được sử dụng.
latestVehicleEndTime Dấu thời gian Thời gian kết thúc mới nhất trong số tất cả các xe đã qua sử dụng.
skippedMandatoryShipmentCount số nguyên Số lượng lô hàng bắt buộc bị bỏ qua.
totalCost số Tổng chi phí của giải pháp, cộng tất cả chi phí của tuyến đường và các khoản tiền phạt do bỏ qua chuyến hàng.
usedVehicleCount số nguyên Số lượng xe được sử dụng trong giải pháp.
AggregatedMetrics
(Một phần của Metrics và ShipmentRoute)		 breakDuration Thời lượng Tổng thời lượng nghỉ trên tất cả các tuyến đường.
costs map (key: string, value: number) Bảng chi tiết về chi phí theo loại (ví dụ: "model.vehicles.cost_per_kilometer", "model.shipments.penalty_cost").
delayDuration Thời lượng Tổng thời gian trễ trên tất cả các tuyến đường.
earliestVehicleStartTime Dấu thời gian Thời gian bắt đầu sớm nhất trong số tất cả các xe được sử dụng.
latestVehicleEndTime Dấu thời gian Thời gian kết thúc mới nhất trong số tất cả các xe đã qua sử dụng.
maxLoads map (key: string, value: VehicleLoad) Tải trọng tối đa mà mọi xe có thể chở tại bất kỳ thời điểm nào trong giải pháp, được khoá theo loại tải.
performedShipmentCount số nguyên Tổng số chuyến vận chuyển được thực hiện trên tất cả các xe.
skippedMandatoryShipmentCount số nguyên Số lượng lô hàng bắt buộc bị bỏ qua.
totalCost số Tổng chi phí của giải pháp, cộng tất cả chi phí của tuyến đường và các khoản tiền phạt do bỏ qua chuyến hàng.
totalDuration Thời lượng Tổng thời lượng của tất cả các tuyến đường (di chuyển + chờ đợi + trễ + nghỉ ngơi + ghé thăm).
travelDistanceMeters số Tổng quãng đường di chuyển (tính bằng mét) trên tất cả các tuyến đường.
travelDuration Thời lượng Tổng thời gian di chuyển trên tất cả các tuyến đường.
usedVehicleCount số nguyên Số lượng xe được sử dụng trong giải pháp.
visitDuration Thời lượng Tổng thời lượng dành cho việc thực hiện các lượt ghé thăm (tải/dỡ) trên tất cả các tuyến đường.
waitDuration Thời lượng Tổng thời gian chờ trên tất cả các tuyến đường.
ShipmentRoute
(Một phần của OptimizeToursResponse)		 breaks[] mảng đối tượng (Break) Danh sách các lần dừng của xe trong tuyến đường.
hasTrafficInfeasibilities boolean (true/false) Cho biết liệu tuyến đường có bất kỳ vấn đề nào không thể thực hiện liên quan đến giao thông hay không.
metrics đối tượng (AggregatedMetrics) Các chỉ số cụ thể cho tuyến đường này, chẳng hạn như tổng quãng đường và thời gian đã đi.
routeCosts map (key: string, value: number) Bảng chi tiết chi phí cho tuyến đường này. Khoá là các loại chi phí (ví dụ: "cost_per_hour") và giá trị là số tiền.
routePolyline đối tượng (EncodedPolyline) Đường nhiều đường được mã hoá thể hiện toàn bộ đường đi của tuyến đường theo địa lý.
routeTotalCost số Tổng chi phí của tuyến đường, tổng của tất cả chi phí trong bản đồ routeCosts.
transitions[] mảng đối tượng (Transition) Danh sách có thứ tự gồm các lượt chuyển đổi (chặng đường) kết nối các lượt truy cập.
vehicleEndTime Dấu thời gian Thời gian xe hoàn thành tuyến đường.
vehicleIndex số nguyên Chỉ mục của xe trong ShipmentModel nguồn thực hiện tuyến đường này.
vehicleLabel chuỗi Nhãn do người dùng xác định của xe, được sao chép từ mô hình yêu cầu.
vehicleStartTime Dấu thời gian Thời gian xe bắt đầu hành trình.
visits[] mảng đối tượng (Visit) Trình tự có thứ tự của các lượt ghé thăm (lấy hàng và giao hàng) do xe thực hiện trên tuyến đường này.
Visit
(Một phần của ShipmentRoute)		 detour Thời lượng Thời gian đi đường vòng thêm của chuyến ghé thăm này so với đường đi thẳng giữa chuyến ghé thăm trước và chuyến ghé thăm tiếp theo.
isPickup boolean (true/false) Nếu true, thì lượt ghé thăm này là lượt đến lấy hàng. Nếu là false, thì đó là một lượt phân phối.
loadDemands map (key: string, value: Load) Nhu cầu tải được đáp ứng trong lượt truy cập này (ví dụ: -1 cho lượt giao hàng). Đây là bản sao của nhu cầu tải VisitRequest tương ứng.
shipmentIndex số nguyên Chỉ mục của trường Shipment trong mô hình nguồn mà lượt truy cập này phục vụ.
shipmentLabel chuỗi Nhãn của lô hàng, được sao chép từ ShipmentModel.
startTime Dấu thời gian Thời gian bắt đầu dự kiến của lượt ghé thăm.
visitLabel chuỗi Nhãn của yêu cầu truy cập, được sao chép từ VisitRequest trong mô hình.
visitRequestIndex số nguyên Chỉ mục của VisitRequest trong danh sách nhận hàng hoặc giao hàng của lô hàng mà lượt ghé thăm này tương ứng.
Transition
(Một phần của ShipmentRoute)		 breakDuration Thời lượng Thời lượng của các khoảng nghỉ trong quá trình chuyển đổi này.
delayDuration Thời lượng Khoảng thời gian trễ phát sinh trong quá trình chuyển đổi này (ví dụ: đến sớm và chờ một khoảng thời gian).
routePolyline đối tượng (EncodedPolyline) Hình nhiều đường được mã hoá biểu thị đường dẫn của chuyển cảnh cụ thể này.
routeToken chuỗi Một mã thông báo không công khai có thể được truyền đến Google Navigation SDK để tạo lại tuyến đường trong khi đi theo chỉ dẫn.
startTime Dấu thời gian Thời gian bắt đầu của hiệu ứng chuyển đổi này.
totalDuration Thời lượng Tổng thời lượng của quá trình chuyển đổi, bao gồm cả thời gian di chuyển, chờ đợi, nghỉ ngơi và trễ.
trafficInfoUnavailable boolean (true/false) Nếu true, tức là không có dữ liệu giao thông cho đoạn đường này.
travelDistanceMeters số Quãng đường đã đi trong quá trình chuyển đổi này, tính bằng mét.
travelDuration Thời lượng Thời gian di chuyển trong quá trình chuyển đổi này.
vehicleLoads map (key: string, value: VehicleLoad) Tải trọng mà xe chở trong quá trình chuyển đổi này, được khoá theo loại tải trọng (ví dụ: "weight").
waitDuration Thời lượng Thời lượng chờ trước khi lượt truy cập tiếp theo có thể bắt đầu.