Package google.maps.routeoptimization.v1

int32

Số lượng lô hàng đã thực hiện. Xin lưu ý rằng một cặp đơn hàng đến lấy và giao tận nơi chỉ được tính một lần.

Duration

Tổng thời gian di chuyển cho một tuyến đường hoặc một giải pháp.

Duration

Tổng thời gian chờ cho một tuyến đường hoặc một giải pháp.

Duration

Tổng thời lượng trễ của một tuyến đường hoặc một giải pháp.

Duration

Tổng thời lượng nghỉ của một tuyến đường hoặc một giải pháp.

Duration

Tổng thời lượng truy cập cho một tuyến đường hoặc một giải pháp.

Duration

Tổng thời lượng phải bằng tổng của tất cả thời lượng ở trên. Đối với các tuyến đường, giá trị này cũng tương ứng với:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

Tổng quãng đường di chuyển cho một tuyến đường hoặc một giải pháp.

map<string, VehicleLoad>

Tải tối đa đạt được trên toàn bộ tuyến đường (resp. giải pháp), cho mỗi số lượng trên tuyến đường này (resp. giải pháp), được tính là giá trị tối đa trên tất cả Transition.vehicle_loads (resp. ShipmentRoute.metrics.max_loads.

string

Bắt buộc. Dự án và vị trí mục tiêu để thực hiện lệnh gọi.

Định dạng: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Nếu bạn không chỉ định vị trí, hệ thống sẽ tự động chọn một khu vực.

AsyncModelConfig

Bắt buộc. Thông tin đầu vào/đầu ra của từng mô hình giao dịch mua, chẳng hạn như đường dẫn tệp và định dạng dữ liệu.

string

Không bắt buộc. Tên mô hình do người dùng xác định, có thể được người dùng dùng làm bí danh để theo dõi các mô hình.

InputConfig

Bắt buộc. Thông tin về mô hình đầu vào.

OutputConfig

Bắt buộc. Thông tin vị trí đầu ra mong muốn.

BreakRequest

Trình tự các điểm chèn quảng cáo. Xem thông báo BreakRequest.

FrequencyConstraint

Có thể áp dụng một số FrequencyConstraint. Tất cả các điều kiện này phải được BreakRequest của BreakRule này đáp ứng. Xem FrequencyConstraint.

Timestamp

Bắt buộc. Giới hạn dưới (bao gồm cả giá trị này) tại thời điểm bắt đầu khoảng nghỉ.

Timestamp

Bắt buộc. Giới hạn trên (bao gồm cả giá trị này) tại thời điểm bắt đầu khoảng nghỉ.

Duration

Bắt buộc. Thời lượng tối thiểu của điểm chèn quảng cáo. Phải dương.

Duration

Bắt buộc. Thời lượng tối thiểu của điểm chèn quảng cáo cho quy tắc ràng buộc này. Không âm. Xem nội dung mô tả về FrequencyConstraint.

Duration

Bắt buộc. Khoảng thời gian tối đa được phép của bất kỳ khoảng thời gian nào trong tuyến đường không bao gồm ít nhất một phần thời gian nghỉ của duration >= min_break_duration. Phải dương.

int64

Giới hạn cứng ràng buộc khoảng cách ở mức tối đa là max_meters. Giới hạn phải là số không âm.

int64

Giới hạn mềm không thực thi giới hạn khoảng cách tối đa, nhưng khi bị vi phạm sẽ dẫn đến một chi phí cộng với các chi phí khác được xác định trong mô hình, với cùng một đơn vị.

Nếu được xác định, soft_max_meters phải nhỏ hơn max_meters và không được âm.

double

Chi phí mỗi km đã phát sinh, tăng lên đến soft_max_meters, theo công thức:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Chi phí này không được hỗ trợ trong route_distance_limit.

double

Chi phí mỗi km phát sinh nếu khoảng cách vượt quá hạn mức soft_max_meters. Chi phí bổ sung là 0 nếu khoảng cách dưới hạn mức, nếu không, công thức dùng để tính chi phí sẽ như sau:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Chi phí phải là số không âm.

string

Bắt buộc. URI Google Cloud Storage.

string

Bắt buộc. URI của một đối tượng Google Cloud Storage có định dạng gs://bucket/path/to/object.

ShipmentRoute

Các tuyến đường của giải pháp cần chèn. Một số tuyến đường có thể bị bỏ qua trong giải pháp ban đầu. Các tuyến đường và lô hàng bị bỏ qua phải đáp ứng các giả định về tính hợp lệ cơ bản được liệt kê cho injected_first_solution_routes.

SkippedShipment

Bỏ qua các lô hàng của giải pháp cần chèn. Một số có thể bị bỏ qua trong giải pháp ban đầu. Xem trường routes.

ConstraintRelaxation

Đối với không hoặc nhiều nhóm xe, hãy chỉ định thời điểm và mức độ nới lỏng các quy tắc ràng buộc. Nếu trường này trống, thì tất cả các tuyến xe không trống đều bị ràng buộc hoàn toàn.

Relaxation

Tất cả các trường hợp nới lỏng quy tắc ràng buộc về lượt truy cập sẽ áp dụng cho các lượt truy cập trên tuyến đường có xe trong vehicle_indices.

int32

Chỉ định các chỉ mục xe mà quy tắc ràng buộc về lượt truy cập relaxations áp dụng. Nếu trống, giá trị này được coi là giá trị mặc định và relaxations áp dụng cho tất cả các phương tiện không được chỉ định trong constraint_relaxations khác. Có thể có tối đa một giá trị mặc định, tức là tối đa một trường nới lỏng quy tắc ràng buộc được phép để trống vehicle_indices. Bạn chỉ có thể liệt kê một chỉ mục xe một lần, ngay cả trong một số constraint_relaxations.

Chỉ mục xe được liên kết giống như ShipmentRoute.vehicle_index, nếu interpret_injected_solutions_using_labels là đúng (xem bình luận fields).

Level

Mức độ nới lỏng quy tắc ràng buộc áp dụng khi các điều kiện tại hoặc sau threshold_time VÀ ít nhất threshold_visit_count được đáp ứng.

Timestamp

Thời gian tại hoặc sau đó có thể áp dụng level thư giãn.

int32

Số lượt truy cập tại hoặc sau thời điểm có thể áp dụng level thư giãn. Nếu threshold_visit_count là 0 (hoặc chưa được đặt), thì level có thể được áp dụng trực tiếp khi xe khởi động.

Nếu là route.visits_size() + 1, thì level chỉ có thể được áp dụng cho đầu xe. Nếu lớn hơn route.visits_size() + 1, level sẽ không được áp dụng cho tuyến đó.

DataFormat

Bắt buộc. Định dạng dữ liệu đầu vào.

GcsSource

Vị trí trên Google Cloud Storage. Đây phải là một đối tượng (tệp) duy nhất.

LatLng

Toạ độ địa lý của điểm trung gian.

int32

Hướng la bàn liên quan đến hướng của luồng giao thông. Giá trị này dùng để chỉ định bên đường để sử dụng cho việc đón và trả khách. Giá trị hướng có thể từ 0 đến 360, trong đó 0 chỉ định hướng chính Bắc, 90 chỉ định hướng chính Đông, v.v.

string

Bắt buộc. Dự án hoặc vị trí mục tiêu để thực hiện cuộc gọi.

Định dạng: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Nếu bạn không chỉ định vị trí, hệ thống sẽ tự động chọn một khu vực.

Duration

Nếu bạn đặt thời gian chờ này, máy chủ sẽ trả về phản hồi trước khi hết khoảng thời gian chờ hoặc hết thời hạn của máy chủ cho các yêu cầu đồng bộ, tuỳ theo thời điểm nào đến sớm hơn.

Đố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ờ.

ShipmentModel

Mô hình vận chuyển cần giải quyết.

SolvingMode

Theo mặc định, chế độ giải là DEFAULT_SOLVE (0).

SearchMode

Chế độ tìm kiếm dùng để giải quyết yêu cầu.

ShipmentRoute

Hướng dẫn thuật toán tối ưu hoá tìm giải pháp đầu tiên tương tự như giải pháp trước đó.

Mô hình bị ràng buộc khi xây dựng giải pháp đầu tiên. Mọi lô hàng không được thực hiện trên một tuyến đường đều bị bỏ qua ngầm ẩn trong giải pháp đầu tiên, nhưng có thể được thực hiện trong các giải pháp tiếp theo.

Giải pháp phải đáp ứng một số giả định cơ bản về tính hợp lệ:

• đối với tất cả các tuyến, vehicle_index phải nằm trong phạm vi và không được trùng lặp.
• đối với tất cả lượt truy cập, shipment_index và visit_request_index phải nằm trong phạm vi.
• một lô hàng chỉ có thể được tham chiếu trên một tuyến đường.
• phải đến lấy hàng trước khi giao hàng.
• không được thực hiện nhiều phương thức giao hàng hoặc phương thức đến lấy hàng thay thế cho một lô hàng.
• đối với tất cả các tuyến, thời gian đang tăng lên (tức là vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• chỉ có thể vận chuyển hàng trên một loại xe được phép. Xe được phép nếu Shipment.allowed_vehicle_indices trống hoặc vehicle_index của xe nằm trong Shipment.allowed_vehicle_indices.

Nếu giải pháp được chèn không khả thi, thì không nhất thiết phải trả về lỗi xác thực mà có thể trả về lỗi cho biết không khả thi.

InjectedSolutionConstraint

Giới hạn thuật toán tối ưu hoá để tìm giải pháp cuối cùng tương tự như giải pháp trước đó. Ví dụ: bạn có thể dùng tính năng này để đóng băng các phần của tuyến đã hoàn tất hoặc sắp hoàn tất nhưng không được sửa đổi.

Nếu giải pháp được chèn không khả thi, thì không nhất thiết phải trả về lỗi xác thực mà có thể trả về lỗi cho biết không khả thi.

ShipmentRoute

Nếu không trống, các tuyến đường đã cho sẽ được làm mới mà không sửa đổi trình tự lượt truy cập hoặc thời gian di chuyển cơ bản của các tuyến đườ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ừ ngày 11/2020, tính năng này chỉ điền sẵn các đường đa tuyến của các tuyến không trống và yêu cầu populate_polylines phải là true.

Các trường route_polyline của các tuyến đường đã truyền có thể không nhất quán với tuyến đường transitions.

Không được sử dụng trường này cùng với injected_first_solution_routes hoặc injected_solution_constraint.

Shipment.ignore và Vehicle.ignore không ảnh hưởng đến hành vi này. Đường đa tuyến vẫn được điền giữa tất cả các lượt truy cập trong tất cả các tuyến không trống, bất kể các chuyến hàng hoặc xe liên quan có bị bỏ qua hay không.

bool

Nếu đúng:

• sử dụng ShipmentRoute.vehicle_label thay vì vehicle_index để so khớp các tuyến trong giải pháp được chèn với các phương tiện trong yêu cầu; sử dụng lại mối liên kết của ShipmentRoute.vehicle_index ban đầu với ShipmentRoute.vehicle_index mới để cập nhật ConstraintRelaxation.vehicle_indices nếu không trống, nhưng mối liên kết phải rõ ràng (tức là nhiều ShipmentRoute không được dùng chung cùng một vehicle_index ban đầu).
• sử dụng ShipmentRoute.Visit.shipment_label thay vì shipment_index để so khớp các lượt truy cập trong giải pháp được chèn với các lô hàng trong yêu cầu;
• sử dụng SkippedShipment.label thay vì SkippedShipment.index để so khớp các lô hàng bị bỏ qua trong giải pháp được chèn với các lô hàng yêu cầu.

Cách diễn giải này áp dụng cho các trường injected_first_solution_routes, injected_solution_constraint và refresh_details_routes. Bạn có thể sử dụng phương thức này khi chỉ mục lô hàng hoặc xe trong yêu cầu đã thay đổi kể từ khi giải pháp được tạo, có thể là do lô hàng hoặc xe đã bị xoá khỏi hoặc thêm vào yêu cầu.

Nếu là true, nhãn trong các danh mục sau đây phải xuất hiện tối đa một lần trong danh mục của nhãn:

• Vehicle.label trong yêu cầu;
• Shipment.label trong yêu cầu;
• ShipmentRoute.vehicle_label trong dung dịch được chèn;
• SkippedShipment.label và ShipmentRoute.Visit.shipment_label trong giải pháp được chèn (ngoại trừ các cặp lượt ghé thăm để lấy hàng/giao hàng, trong đó shipment_label phải xuất hiện hai lần).

Nếu vehicle_label trong giải pháp được chèn không tương ứng với một xe yêu cầu, thì tuyến đường tương ứng sẽ bị xoá khỏi giải pháp cùng với các lượt truy cập của tuyến đường đó. Nếu shipment_label trong giải pháp được chèn không tương ứng với một lô hàng yêu cầu, thì lượt truy cập tương ứng sẽ bị xoá khỏi giải pháp. Nếu SkippedShipment.label trong giải pháp được chèn không tương ứng với một yêu cầu vận chuyển, thì SkippedShipment sẽ bị xoá khỏi giải pháp.

Việc xoá các lượt truy cập tuyến hoặc toàn bộ tuyến khỏi giải pháp được chèn có thể ảnh hưởng đến các quy tắc ràng buộc ngầm ẩn, dẫn đến thay đổi trong giải pháp, lỗi xác thực hoặc không khả thi.

LƯU Ý: Phương thức gọi phải đảm bảo rằng mỗi Vehicle.label (tương ứng với Shipment.label) xác định duy nhất một thực thể xe (hoặc lô hàng) được sử dụng trên hai yêu cầu có liên quan: yêu cầu trước đó đã tạo OptimizeToursResponse được sử dụng trong giải pháp được chèn và yêu cầu hiện tại bao gồm giải pháp được chèn. Các bước kiểm tra tính duy nhất được mô tả ở trên là chưa đủ để đảm bảo yêu cầu này.

bool

Hãy cân nhắc việc ước tính lưu lượng truy cập khi tính toán các trường ShipmentRoute Transition.travel_duration, Visit.start_time và vehicle_end_time; khi đặt trường ShipmentRoute.has_traffic_infeasibilities và khi tính toán trường OptimizeToursResponse.total_cost.

bool

Nếu đúng, các đường đa tuyến sẽ được điền vào ShipmentRoute phản hồi.

bool

Nếu là true, các đường đa tuyến và mã thông báo tuyến sẽ được điền trong phản hồi ShipmentRoute.transitions.

bool

Nếu bạn đặt giá trị này, thì yêu cầu có thể có thời hạn (xem https://grpc.io/blog/deadlines) tối đa là 60 phút. 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 tồn tại lâu có nguy cơ bị gián đoạn lớn hơn đáng kể (nhưng vẫn nhỏ).

bool

Nếu đúng, quãng đường di chuyển sẽ được tính bằ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 khoảng cách trắc địa với tốc độ do geodesic_meters_per_second xác định.

string

Nhãn có thể được dùng để xác định yêu cầu này, được báo cáo lại trong OptimizeToursResponse.request_label.

double

Khi use_geodesic_distances là true, bạn phải đặt trường này và xác định tốc độ áp dụng để tính thời gian di chuyển. Giá trị của thuộc tính này phải ít nhất là 1,0 mét/giây.

int32

Cắt bớt số lỗi xác thực được trả về. Các lỗi này thường được đính kèm vào tải trọng lỗi INVALID_ARGUMENT dưới dạng thông tin chi tiết về lỗi BadRequest (https://cloud.google.com/apis/design/errors#error_details), trừ khi solving_mode=VALIDATE_ONLY: xem trường OptimizeToursResponse.validation_errors. Giá trị này mặc định là 100 và được giới hạn ở mức 10.000.

ShipmentRoute

Các tuyến đường được tính toán cho mỗi xe; tuyến đường thứ i tương ứng với xe thứ i trong mô hình.

string

Bản sao của OptimizeToursRequest.label, nếu bạn đã chỉ định nhãn trong yêu cầu.

SkippedShipment

Danh sách tất cả các lô hàng bị bỏ qua.

OptimizeToursValidationError

Danh sách tất cả lỗi xác thực mà chúng tôi có thể phát hiện một cách độc lập. Xem nội dung giải thích "MULTIPLE ERRORS" (Nhiều lỗi) cho thông báo OptimizeToursValidationError. Thay vì lỗi, thông báo này sẽ bao gồm cảnh báo trong trường hợp solving_mode là DEFAULT_SOLVE.

Metrics

Chỉ số về thời lượng, khoảng cách và mức sử dụng của giải pháp này.

AggregatedMetrics

Tổng hợp trên các tuyến đường. Mỗi chỉ số là tổng (hoặc tối đa, đối với tải) trên tất cả các trường ShipmentRoute.metrics có cùng tên.

int32

Số lượng lô hàng bắt buộc bị bỏ qua.

int32

Số lượng xe được sử dụng. Lưu ý: nếu tuyến xe trống và Vehicle.used_if_route_is_empty là true, thì xe được coi là đã qua sử dụng.

Timestamp

Thời gian bắt đầu sớm nhất của một xe đã qua sử dụng, được tính là giá trị tối thiểu trên tất cả xe đã qua sử dụng của ShipmentRoute.vehicle_start_time.

Timestamp

Thời gian kết thúc mới nhất của một xe đã qua sử dụng, được tính là giá trị tối đa trên tất cả xe đã qua sử dụng của ShipmentRoute.vehicle_end_time.

map<string, double>

Chi phí của giải pháp, được phân tích theo các trường yêu cầu liên quan đến chi phí. Khoá là đường dẫn proto, tương ứng với OptimizeToursRequest đầu vào, ví dụ: "model.shipments.pickups.cost" và giá trị là tổng chi phí do trường chi phí tương ứng tạo ra, được tổng hợp trên toàn bộ giải pháp. Nói cách khác, costs["model.shipments.pickups.cost"] là tổng chi phí lấy hàng trên giải pháp. Tất cả chi phí được xác định trong mô hình đều được báo cáo chi tiết tại đây, ngoại trừ chi phí liên quan đến TransitionAttributes chỉ được báo cáo theo cách tổng hợp kể từ ngày 1/1/2022.

double

Tổng chi phí của giải pháp. Tổng của tất cả các giá trị trong bản đồ chi phí.

int32

Lỗi xác thực được xác định bằng cặp (code, display_name) luôn xuất hiện.

Các trường sau phần này cung cấp thêm thông tin về lỗi.

MULTIPLE ERRORS (NHIỀU LỖI): Khi có nhiều lỗi, quy trình xác thực sẽ cố gắng xuất ra một số lỗi trong số đó. Tương tự như trình biên dịch, đây là một quy trình không hoàn hảo. Một số lỗi xác thực sẽ là "lỗi nghiêm trọng", nghĩa là các lỗi này sẽ dừng toàn bộ quá trình xác thực. Đây là trường hợp của các lỗi display_name="UNSPECIFIED", v.v. Một số lỗi có thể khiến quá trình xác thực bỏ qua các lỗi khác.

TÍNH ỔN ĐỊNH: code và display_name phải rất ổn định. Tuy nhiên, các mã và tên hiển thị mới có thể xuất hiện theo thời gian, điều này có thể khiến một yêu cầu (không hợp lệ) nhất định tạo ra một cặp (code, display_name) khác vì lỗi mới đã ẩn lỗi cũ. Ví dụ: hãy xem "MULTIPLE ERRORS" (Nhiều lỗi).

string

Tên hiển thị của lỗi.

FieldReference

Ngữ cảnh lỗi có thể liên quan đến 0, 1 (trong hầu hết trường hợp) hoặc nhiều trường. Ví dụ: tham khảo xe #4 và lượt lấy hàng đầu tiên của lô hàng #2 như sau:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

Tuy nhiên, lưu ý rằng số lượng giá trị riêng biệt của fields không được thay đổi đối với một mã lỗi nhất định.

string

Chuỗi ký tự mà con người đọc được, dùng để mô tả lỗi. Có mối liên kết 1:1 giữa code và error_message (khi code != "UNSPECIFIED").

STABILITY (ỔN ĐỊNH): Không ổn định: thông báo lỗi liên kết với một code nhất định có thể thay đổi theo thời gian (hy vọng là để làm rõ thông báo đó). Thay vào đó, vui lòng sử dụng display_name và code.

string

Có thể chứa(các) giá trị của(các) trường. Tính năng này không phải lúc nào cũng có. Bạn tuyệt đối không nên dựa vào tính năng này và chỉ nên sử dụng tính năng này để gỡ lỗi mô hình theo cách thủ công.

string

Tên trường, ví dụ: "vehicles".

FieldReference

Trường con lồng nhau đệ quy, nếu cần.

int32

Chỉ mục của trường nếu lặp lại.

string

Khoá nếu trường là một bản đồ.

DataFormat

Bắt buộc. Định dạng dữ liệu đầu ra.

GcsDestination

Vị trí Google Cloud Storage để ghi đầu ra.

bool

Chỉ định xem có tránh đường thu phí hay không (nếu hợp lý). Chúng tôi sẽ ưu tiên các tuyến đường không có đường thu phí. Chỉ áp dụng cho các phương tiện di chuyển bằng động cơ.

bool

Chỉ định xem có nên tránh đường cao tốc hay không (nếu hợp lý). Chúng tôi sẽ ưu tiên các tuyến đường không có đường cao tốc. Chỉ áp dụng cho các phương tiện di chuyển bằng động cơ.

bool

Chỉ định xem có tránh phà hay không khi hợp lý. Ưu tiên các tuyến không có phương tiện đi lại bằng phà. Chỉ áp dụng cho các phương tiện di chuyển bằng động cơ.

bool

Không bắt buộc. Chỉ định xem có nên tránh điều hướng trong nhà khi hợp lý hay không. Các tuyến không chứa thông tin chỉ đường trong nhà sẽ được ưu tiên. Chỉ áp dụng cho chế độ đi lại WALKING.

string

Tên hiển thị do người dùng xác định của lô hàng. Tên này có thể dài tối đa 63 ký tự và có thể sử dụng ký tự UTF-8.

VisitRequest

Tập hợp các địa điểm lấy hàng thay thế liên kết với lô hàng. Nếu không được chỉ định, xe chỉ cần đến một vị trí tương ứng với các đơn hàng giao.

VisitRequest

Tập hợp các phương thức giao hàng thay thế liên kết với lô hàng. Nếu không được chỉ định, xe chỉ cần đến một vị trí tương ứng với điểm đến lấy hàng.

map<string, Load>

Yêu cầu về tải trọng của lô hàng (ví dụ: trọng lượng, thể tích, số lượng pallet, v.v.). Khoá trong bản đồ phải là giá trị nhận dạng mô tả loại tải tương ứng, tốt nhất là cũng bao gồm cả đơn vị. Ví dụ: "weight_kg", "volume_gallons", "pallet_count", v.v. Nếu một khoá nhất định không xuất hiện trong bản đồ, thì tải tương ứng sẽ được coi là rỗng.

int32

Tập hợp các phương tiện có thể thực hiện lô hàng này. Nếu trống, tất cả xe đều có thể thực hiện thao tác này. Xe được cung cấp theo chỉ mục trong danh sách vehicles của ShipmentModel.

double

Chỉ định chi phí phát sinh khi mỗi xe vận chuyển lô hàng này. Nếu được chỉ định, thuộc tính này phải có MỘT trong những thuộc tính sau:

• có cùng số phần tử với costs_per_vehicle_indices. costs_per_vehicle[i] tương ứng với xe costs_per_vehicle_indices[i] của mô hình.
• có cùng số phần tử với số lượng xe trong mô hình. Phần tử thứ i tương ứng với xe #i của mô hình.

Các chi phí này phải có cùng đơn vị với penalty_cost và không được âm. Để trống trường này nếu không có chi phí nào như vậy.

int32

Chỉ mục của các xe mà costs_per_vehicle áp dụng. Nếu không trống, mảng này phải có cùng số phần tử với costs_per_vehicle. Bạn không được chỉ định chỉ mục xe nhiều lần. Nếu một xe bị loại trừ khỏi costs_per_vehicle_indices, thì chi phí của xe đó sẽ bằng 0.

Duration

Chỉ định thời gian đi đường vòng tuyệt đối tối đa so với đường đi ngắn nhất từ điểm đến điểm đến. Nếu được chỉ định, giá trị này phải là số không âm và lô hàng phải chứa ít nhất một lượt lấy hàng và một lượt giao hàng.

Ví dụ: giả sử t là thời gian ngắn nhất để đi từ lựa chọn đến lấy hàng đã chọn đến lựa chọn giao hàng đã chọn. Sau đó, việc thiết lập pickup_to_delivery_absolute_detour_limit sẽ thực thi:

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

Nếu cả giới hạn tương đối và giới hạn tuyệt đối đều được chỉ định trên cùng một lô hàng, thì giới hạn hạn chế hơn sẽ được dùng cho mỗi cặp điểm đến lấy hàng/điểm đến giao hàng có thể có. Kể từ tháng 10 năm 2017, chúng tôi chỉ hỗ trợ đường tránh khi thời gian di chuyển không phụ thuộc vào loại xe.

Duration

Chỉ định khoảng thời gian tối đa từ khi bắt đầu lấy hàng đến khi bắt đầu giao hàng. Nếu được chỉ định, giá trị này phải là số không âm và lô hàng phải chứa ít nhất một lượt lấy hàng và một lượt giao hàng. Thời gian này không phụ thuộc vào phương án thay thế được chọn để đến lấy hàng và giao hàng, cũng như không phụ thuộc vào tốc độ xe. Bạn có thể chỉ định điều này cùng với các quy tắc ràng buộc về đường tránh tối đa: giải pháp sẽ tuân thủ cả hai thông số kỹ thuật.

string

Chuỗi không trống chỉ định "loại" cho lô hàng này. Bạn có thể dùng tính năng này để xác định các yêu cầu hoặc sự không tương thích giữa shipment_types (xem shipment_type_incompatibilities và shipment_type_requirements trong ShipmentModel).

Khác với visit_types được chỉ định cho một lượt truy cập: Tất cả lượt lấy hàng/giao hàng thuộc cùng một lô hàng đều có cùng một shipment_type.

string

Chỉ định nhãn cho lô hàng này. Nhãn này được báo cáo trong phản hồi trong shipment_label của ShipmentRoute.Visit tương ứng.

bool

Nếu đúng, hãy bỏ qua lô hàng này nhưng không áp dụng penalty_cost.

Việc bỏ qua một lô hàng sẽ dẫn đến lỗi xác thực khi có bất kỳ shipment_type_requirements nào trong mô hình.

Bạn có thể bỏ qua một lô hàng được thực hiện trong injected_first_solution_routes hoặc injected_solution_constraint; trình giải sẽ xoá các lượt lấy hàng/giao hàng liên quan khỏi tuyến đường thực hiện. precedence_rules tham chiếu đến các lô hàng bị bỏ qua cũng sẽ bị bỏ qua.

double

Nếu lô hàng không được hoàn tất, khoản phạt này sẽ được cộng vào tổng chi phí của các tuyến. Một lô hàng được coi là đã hoàn tất nếu người dùng đã đến một trong các địa điểm đến lấy hàng và giao hàng thay thế. Chi phí có thể được thể hiện bằng cùng một đơn vị được dùng cho tất cả các trường khác liên quan đến chi phí trong mô hình và phải là số dương.

LƯU Ý QUAN TRỌNG: Nếu bạn không chỉ định hình phạt này, thì hình phạt này sẽ được coi là vô thời hạn, tức là đơn hàng phải được hoàn tất.

double

Chỉ định thời gian đi đường vòng tương đối tối đa so với đường ngắn nhất từ điểm đến điểm lấy hàng đến điểm giao hàng. Nếu được chỉ định, giá trị này phải là số không âm và lô hàng phải chứa ít nhất một lượt lấy hàng và một lượt giao hàng.

Ví dụ: giả sử t là thời gian ngắn nhất để đi từ lựa chọn đến lấy hàng đã chọn đến lựa chọn giao hàng đã chọn. Sau đó, việc thiết lập pickup_to_delivery_relative_detour_limit sẽ thực thi:

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

Nếu cả giới hạn tương đối và giới hạn tuyệt đối đều được chỉ định trên cùng một lô hàng, thì giới hạn hạn chế hơn sẽ được dùng cho mỗi cặp điểm đến lấy hàng/điểm đến giao hàng có thể có. Kể từ tháng 10 năm 2017, chúng tôi chỉ hỗ trợ đường tránh khi thời gian di chuyển không phụ thuộc vào loại xe.

int64

Mức tải của xe thực hiện lượt truy cập tương ứng sẽ thay đổi. Vì đây là số nguyên nên người dùng nên chọn một đơn vị thích hợp để tránh mất độ chính xác. Phải ≥ 0.

LatLng

Vị trí địa lý nơi xe đến khi thực hiện VisitRequest này. Nếu mô hình lô hàng có ma trận khoảng cách theo thời gian, bạn không được chỉ định arrival_location.

Waypoint

Điểm trung gian mà xe đến khi thực hiện VisitRequest này. Nếu mô hình lô hàng có ma trận khoảng cách theo thời gian, bạn không được chỉ định arrival_waypoint.

LatLng

Vị trí địa lý nơi xe khởi hành sau khi hoàn tất VisitRequest này. Có thể bỏ qua nếu giá trị này giống với arrival_location. Nếu mô hình lô hàng có ma trận khoảng cách theo thời gian, bạn không được chỉ định departure_location.

Waypoint

Điểm trung gian mà xe khởi hành sau khi hoàn tất VisitRequest này. Có thể bỏ qua nếu giá trị này giống với arrival_waypoint. Nếu mô hình lô hàng có ma trận khoảng cách theo thời gian, bạn không được chỉ định departure_waypoint.

string

Chỉ định các thẻ đính kèm vào yêu cầu truy cập. Không được phép sử dụng chuỗi trống hoặc trùng lặp.

TimeWindow

Khung thời gian ràng buộc thời gian đến trong một lượt truy cập. Xin lưu ý rằng một xe có thể khởi hành ngoài khoảng thời gian đến, tức là thời gian đến + thời lượng không cần nằm trong khoảng thời gian. Điều này có thể dẫn đến thời gian chờ nếu xe đến trước TimeWindow.start_time.

Nếu không có TimeWindow, thì xe có thể thực hiện lượt ghé thăm này bất cứ lúc nào.

Các khoảng thời gian phải tách biệt, tức là không có khoảng thời gian nào được chồng chéo hoặc liền kề với khoảng thời gian khác và các khoảng thời gian phải được sắp xếp theo thứ tự tăng dần.

Bạn chỉ có thể đặt cost_per_hour_after_soft_end_time và soft_end_time nếu có một khoảng thời gian duy nhất.

Duration

Thời lượng của lượt truy cập, tức là thời gian xe ở lại từ khi đến đến khi rời đi (sẽ được thêm vào thời gian chờ có thể xảy ra; xem time_windows).

double

Chi phí để thực hiện yêu cầu về lượt ghé thăm này trên tuyến đường của xe. Bạn có thể dùng phương thức thanh toán này để thanh toán các khoản phí khác nhau cho mỗi lần lấy hàng hoặc giao hàng thay thế. Chi phí này phải có cùng đơn vị với Shipment.penalty_cost và không được âm.

map<string, Load>

Tải các yêu cầu của yêu cầu truy cập này. Trường này cũng giống như trường Shipment.load_demands, ngoại trừ việc trường này chỉ áp dụng cho VisitRequest này thay vì toàn bộ Shipment. Các yêu cầu được liệt kê ở đây được thêm vào các yêu cầu được liệt kê trong Shipment.load_demands.

string

Chỉ định các loại lượt truy cập. Bạn có thể sử dụng thông tin này để phân bổ thêm thời gian cần thiết cho một xe hoàn tất lượt ghé thăm này (xem Vehicle.extra_visit_duration_for_visit_type).

Một loại chỉ có thể xuất hiện một lần.

string

Chỉ định nhãn cho VisitRequest này. Nhãn này được báo cáo trong phản hồi dưới dạng visit_label trong ShipmentRoute.Visit tương ứng.

Shipment

Tập hợp các lô hàng phải được thực hiện trong mô hình.

Vehicle

Tập hợp các xe có thể dùng để thực hiện lượt ghé thăm.

Timestamp

Thời gian bắt đầu và kết thúc chung của mô hình: không có thời gian nào nằm ngoài phạm vi này được coi là hợp lệ.

Khoảng thời gian của mô hình phải dưới một năm, tức là global_end_time và global_start_time phải cách nhau trong vòng 31536000 giây.

Khi sử dụng các trường cost_per_*hour, bạn nên đặt khoảng thời gian này thành một khoảng thời gian nhỏ hơn để tăng hiệu suất (ví dụ: nếu lập mô hình một ngày, bạn nên đặt giới hạn thời gian chung thành ngày đó). Nếu bạn không đặt giá trị, hệ thống sẽ sử dụng giá trị mặc định là 00:00:00 UTC, ngày 1 tháng 1 năm 1970 (tức là giây: 0, nano giây: 0).

Timestamp

Nếu bạn không đặt giá trị, hệ thống sẽ sử dụng giá trị mặc định là 00:00:00 UTC, ngày 1 tháng 1 năm 1971 (tức là giây: 31536000, nano giây: 0).

double

"Thời lượng tổng thể" của kế hoạch tổng thể là chênh lệch giữa thời gian bắt đầu có hiệu lực sớm nhất và thời gian kết thúc có hiệu lực muộn nhất của tất cả xe. Ví dụ: người dùng có thể chỉ định chi phí mỗi giờ cho số lượng đó để cố gắng tối ưu hoá nhằm hoàn thành công việc sớm nhất. Chi phí này phải có cùng đơn vị với Shipment.penalty_cost.

DurationDistanceMatrix

Chỉ định ma trận thời lượng và khoảng cách được sử dụng trong mô hình. Nếu trường này trống, Google Maps hoặc khoảng cách trắc địa sẽ được sử dụng, tuỳ thuộc vào giá trị của trường use_geodesic_distances. Nếu không để trống, use_geodesic_distances không được là true và duration_distance_matrix_src_tags cũng như duration_distance_matrix_dst_tags không được để trống.

Ví dụ về cách sử dụng:

• Có hai vị trí: locA và locB.
• 1 xe bắt đầu tuyến đường tại locA và kết thúc tại locA.
• 1 yêu cầu đến lấy hàng tại locB.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• Có 3 vị trí: locA, locB và locC.
• 1 xe bắt đầu tuyến đường tại locA và kết thúc tại locB, sử dụng ma trận "nhanh".
• 1 xe bắt đầu tuyến đường tại locB và kết thúc tại locB, sử dụng ma trận "chậm".
• 1 xe bắt đầu tuyến đường tại locB và kết thúc tại locB, sử dụng ma trận "nhanh".
• 1 yêu cầu đến lấy hàng tại locC.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

Thẻ xác định nguồn của ma trận thời lượng và khoảng cách; duration_distance_matrices(i).rows(j) xác định thời lượng và khoảng cách từ các lượt truy cập có thẻ duration_distance_matrix_src_tags(j) đến các lượt truy cập khác trong ma trận i.

Thẻ tương ứng với VisitRequest.tags hoặc Vehicle.start_tags. Một VisitRequest hoặc Vehicle nhất định phải khớp chính xác với một thẻ trong trường này. Xin lưu ý rằng thẻ nguồn, đích và ma trận của Vehicle có thể giống nhau; tương tự, thẻ nguồn và đích của VisitRequest có thể giống nhau. Tất cả thẻ phải khác nhau và không được là chuỗi trống. Nếu trường này không để trống, thì duration_distance_matrices không được để trống.

string

Thẻ xác định đích đến của ma trận thời lượng và khoảng cách; duration_distance_matrices(i).rows(j).durations(k) (tương ứng duration_distance_matrices(i).rows(j).meters(k)) xác định thời lượng (tương ứng là khoảng cách) của chuyến đi từ các lượt truy cập có thẻ duration_distance_matrix_src_tags(j) đến các lượt truy cập có thẻ duration_distance_matrix_dst_tags(k) trong ma trận i.

Thẻ tương ứng với VisitRequest.tags hoặc Vehicle.start_tags. Một VisitRequest hoặc Vehicle nhất định phải khớp chính xác với một thẻ trong trường này. Xin lưu ý rằng thẻ nguồn, đích và ma trận của Vehicle có thể giống nhau; tương tự, thẻ nguồn và đích của VisitRequest có thể giống nhau. Tất cả thẻ phải khác nhau và không được là chuỗi trống. Nếu trường này không để trống, thì duration_distance_matrices không được để trống.

TransitionAttributes

Thêm các thuộc tính chuyển đổi vào mô hình.

ShipmentTypeIncompatibility

Các tập hợp shipment_types không tương thích (xem ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Các nhóm yêu cầu shipment_type (xem ShipmentTypeRequirement).

PrecedenceRule

Tập hợp các quy tắc ưu tiên phải được thực thi trong mô hình.

int32

Giới hạn số lượng tối đa của xe đang hoạt động. Xe được coi là đang hoạt động nếu tuyến đường của xe thực hiện ít nhất một chuyến hàng. Bạn có thể dùng thông tin này để giới hạn số lượng tuyến trong trường hợp có ít tài xế hơn số lượng xe và đội xe không đồng nhất. Sau đó, tính năng tối ưu hoá sẽ chọn nhóm xe phù hợp nhất để sử dụng. Phải là số dương.

Row

Chỉ định các hàng của ma trận thời lượng và khoảng cách. Mảng này phải có số phần tử bằng ShipmentModel.duration_distance_matrix_src_tags.

string

Thẻ xác định những loại xe áp dụng cho ma trận thời lượng và quãng đường này. Nếu trống, giá trị này sẽ áp dụng cho tất cả xe và chỉ có thể có một ma trận.

Mỗi lần khởi động xe phải khớp chính xác với một ma trận, tức là đúng một trường start_tags của chúng phải khớp với vehicle_start_tag của một ma trận (và chỉ của ma trận đó).

Tất cả các ma trận phải có vehicle_start_tag khác nhau.

Duration

Giá trị thời lượng cho một hàng nhất định. Mảng này phải có số phần tử bằng ShipmentModel.duration_distance_matrix_dst_tags.

double

Giá trị khoảng cách cho một hàng nhất định. Nếu không có chi phí hoặc quy tắc ràng buộc nào tham chiếu đến khoảng cách trong mô hình, thì bạn có thể để trống phần tử này; nếu không, phần tử này phải có số phần tử bằng durations.

bool

Cho biết liệu sự kiện "đầu tiên" có phải là một lượt phân phối hay không.

bool

Cho biết liệu sự kiện "thứ hai" có phải là một lượt phân phối hay không.

Duration

Độ lệch giữa sự kiện "đầu tiên" và sự kiện "thứ hai". Giá trị này có thể là âm.

int32

Chỉ mục lô hàng của sự kiện "đầu tiên". Bạn phải chỉ định trường này.

int32

Chỉ mục lô hàng của sự kiện "thứ hai". Bạn phải chỉ định trường này.

int32

Xe thực hiện tuyến đường, được xác định bằng chỉ mục của xe trong nguồn ShipmentModel.

string

Nhãn của xe thực hiện tuyến đường này, bằng ShipmentModel.vehicles(vehicle_index).label nếu được chỉ định.

Timestamp

Thời gian xe bắt đầu hành trình.

Timestamp

Thời gian xe hoàn tất tuyến đường.

Visit

Trình tự các lượt truy cập theo thứ tự đại diện cho một tuyến đường. visits[i] là lượt truy cập thứ i trong tuyến đường. Nếu trường này trống, thì xe sẽ được coi là không sử dụng.

Transition

Danh sách các hiệu ứng chuyển đổi theo thứ tự cho tuyến đường.

bool

Khi OptimizeToursRequest.consider_road_traffic được đặt thành true, trường này cho biết rằng sự không nhất quán về thời gian tuyến đường được dự đoán bằng cách sử dụng thông tin ước tính về thời gian di chuyển dựa trên lưu lượng truy cập. Có thể không đủ thời gian để hoàn tất hành trình đã điều chỉnh theo lưu lượng truy cập, độ trễ và thời gian nghỉ giữa các lượt truy cập, trước lượt truy cập đầu tiên hoặc sau lượt truy cập cuối cùng, trong khi vẫn đáp ứng khoảng thời gian truy cập và thời gian của xe. Ví dụ:

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

Thời điểm đến next_visit có thể trễ hơn khung thời gian hiện tại do thời gian di chuyển ước tính travel_duration(previous_visit, next_visit) tăng lên do lưu lượng truy cập. Ngoài ra, thời gian nghỉ có thể bị buộc phải trùng lặp với một lượt truy cập do thời gian di chuyển ước tính tăng lên và các quy định hạn chế về thời gian truy cập hoặc thời gian nghỉ.

EncodedPolyline

Hình nhiều đường đã mã hoá đại diện cho tuyến đường. Trường này chỉ được điền nếu bạn đặt OptimizeToursRequest.populate_polylines thành true.

Break

Thời gian nghỉ theo lịch cho xe thực hiện tuyến đường này. Trình tự breaks biểu thị các khoảng thời gian, mỗi khoảng thời gian bắt đầu tại start_time tương ứng và kéo dài duration giây.

AggregatedMetrics

Các chỉ số về thời lượng, quãng đường và tải cho tuyến đường này. Các trường của AggregatedMetrics được cộng trên tất cả ShipmentRoute.transitions hoặc ShipmentRoute.visits, tuỳ thuộc vào ngữ cảnh.

map<string, double>

Chi phí của tuyến đường, được phân tích theo các trường yêu cầu liên quan đến chi phí. Các khoá là đường dẫn proto, tương ứng với OptimizeToursRequest đầu vào, ví dụ: "model.shipments.pickups.cost" và các giá trị là tổng chi phí do trường chi phí tương ứng tạo ra, được tổng hợp trên toàn bộ tuyến đường. Nói cách khác, costs["model.shipments.pickups.cost"] là tổng chi phí lấy hàng trên tuyến đường. Tất cả chi phí được xác định trong mô hình đều được báo cáo chi tiết tại đây, ngoại trừ chi phí liên quan đến TransitionAttributes chỉ được báo cáo theo cách tổng hợp kể từ ngày 1/1/2022.

double

Tổng chi phí của tuyến đường. Tổng tất cả chi phí trong bản đồ chi phí.

Timestamp

Thời gian bắt đầu nghỉ giải lao.

Duration

Thời lượng của một khoảng nghỉ.

string

Chuỗi đại diện cho các điểm được mã hoá của đa tuyến.

Duration

Thời gian di chuyển trong quá trình chuyển đổi này.

double

Quãng đường đã đi trong quá trình chuyển đổi.

bool

Khi lưu lượng truy cập được yêu cầu thông qua OptimizeToursRequest.consider_road_traffic và không thể truy xuất thông tin lưu lượng truy cập cho Transition, boolean này được đặt thành true. Tình trạng này có thể là tạm thời (hiếm khi xảy ra sự cố trong máy chủ lưu trữ dữ liệu giao thông theo thời gian thực) hoặc vĩnh viễn (không có dữ liệu cho vị trí này).

Duration

Tổng thời lượng độ trễ áp dụng cho quá trình chuyển đổi này. Nếu có, độ trễ sẽ bắt đầu chính xác delay_duration giây trước sự kiện tiếp theo (lượt truy cập hoặc kết thúc xe). Vui lòng xem TransitionAttributes.delay.

Duration

Tổng thời lượng của các khoảng nghỉ xảy ra trong quá trình chuyển đổi này (nếu có). Thông tin chi tiết về thời gian bắt đầu và thời lượng của mỗi khoảng nghỉ được lưu trữ trong ShipmentRoute.breaks.

Duration

Thời gian chờ trong quá trình chuyển đổi này. Thời gian chờ tương ứng với thời gian rảnh và không bao gồm thời gian nghỉ. Ngoài ra, hãy lưu ý rằng thời gian chờ này có thể được chia thành nhiều khoảng không liên tục.

Duration

Tổng thời lượng của quá trình chuyển đổi, được cung cấp để thuận tiện. Giá trị này bằng:

• lượt truy cập tiếp theo start_time (hoặc vehicle_end_time nếu đây là lượt chuyển đổi cuối cùng) – start_time của lượt chuyển đổi này;
• nếu ShipmentRoute.has_traffic_infeasibilities là sai, thì điều sau đây cũng đúng: `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Thời gian bắt đầu chuyển đổi này.

EncodedPolyline

Hình nhiều đường được mã hoá thể hiện tuyến đường được tuân theo trong quá trình chuyển đổi. Trường này chỉ được điền nếu bạn đặt populate_transition_polylines thành true.

string

Chỉ có đầu ra. Mã thông báo mờ có thể được truyền đến Navigation SDK để tái tạo tuyến đường trong quá trình điều hướng và trong trường hợp định tuyến lại, hãy tuân thủ ý định ban đầu khi tạo tuyến đường. Xem mã thông báo này là một blob mờ. Đừng so sánh giá trị của thuộc tính này trên các yêu cầu vì giá trị của thuộc tính này có thể thay đổi ngay cả khi dịch vụ trả về cùng một tuyến. Trường này chỉ được điền nếu bạn đặt populate_transition_polylines thành true.

map<string, VehicleLoad>

Tải xe trong quá trình chuyển đổi này, cho mỗi loại xuất hiện trong Vehicle.load_limits của xe này hoặc có Shipment.load_demands khác 0 trên một số lô hàng được thực hiện trên tuyến này.

Tải trong quá trình chuyển đổi đầu tiên là tải bắt đầu của tuyến đường xe. Sau đó, sau mỗi lượt truy cập, load_demands của lượt truy cập sẽ được cộng hoặc trừ để tải lượt chuyển đổi tiếp theo, tuỳ thuộc vào việc lượt truy cập là lượt đến lấy hàng hay lượt giao hàng.

int64

Lượng tải trên xe, đối với loại xe nhất định. Đơn vị tải thường được chỉ định theo loại. Vui lòng xem Transition.vehicle_loads.

int32

Chỉ mục của trường shipments trong ShipmentModel nguồn.

bool

Nếu đúng, lượt truy cập sẽ tương ứng với một lượt lấy hàng của Shipment. Nếu không, mã này sẽ tương ứng với một lượt phân phối.

int32

Chỉ mục của VisitRequest trong trường đến lấy hàng hoặc giao hàng của Shipment (xem is_pickup).

Timestamp

Thời gian bắt đầu lượt truy cập. Xin lưu ý rằng xe có thể đến sớm hơn thời gian này tại địa điểm ghé thăm. Thời gian nhất quán với ShipmentModel.

map<string, Load>

Tổng nhu cầu tải lượt truy cập là tổng số lô hàng và yêu cầu truy cập load_demands. Các giá trị này sẽ âm nếu lượt truy cập là một lượt phân phối. Nhu cầu được báo cáo cho cùng một loại với Transition.loads (xem trường này).

Duration

Thời gian rẽ đường bổ sung do các lô hàng đã được ghé thăm trên tuyến đường trước khi ghé thăm và thời gian chờ có thể xảy ra do các khung thời gian. Nếu lượt ghé thăm là lượt giao hàng, thì quãng đường vòng sẽ được tính từ lượt ghé thăm đến lấy hàng tương ứng và bằng:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

Nếu không, giá trị này được tính từ start_location của xe và bằng:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Bản sao của Shipment.label tương ứng, nếu được chỉ định trong Shipment.

string

Bản sao của VisitRequest.label tương ứng, nếu được chỉ định trong VisitRequest.

string

Danh sách các loại không tương thích. Hai lô hàng có shipment_types khác nhau trong số các lô hàng được liệt kê là "không tương thích".

IncompatibilityMode

Chế độ áp dụng cho trường hợp không tương thích.

string

Danh sách các loại phương thức vận chuyển thay thế mà dependent_shipment_types yêu cầu.

string

Tất cả các lô hàng có loại trong trường dependent_shipment_types đều yêu cầu ít nhất một lô hàng thuộc loại required_shipment_type_alternatives được ghé thăm trên cùng một tuyến đường.

LƯU Ý: Không được phép tạo chuỗi yêu cầu như shipment_type phụ thuộc vào chính nó.

RequirementMode

Chế độ áp dụng cho yêu cầu.

int32

Chỉ mục này tương ứng với chỉ mục của lô hàng trong ShipmentModel nguồn.

string

Bản sao của Shipment.label tương ứng, nếu được chỉ định trong Shipment.

Reason

Danh sách lý do giải thích lý do lô hàng bị bỏ qua. Xem bình luận ở trên Reason. Nếu chúng tôi không hiểu lý do một lô hàng bị bỏ qua, thì hệ thống sẽ không đặt lý do.

Code

Tham khảo các nhận xét về Mã.

string

Nếu mã lý do là DEMAND_EXCEEDS_VEHICLE_CAPACITY, hãy ghi lại một loại dung lượng đã vượt quá.

int32

Nếu lý do liên quan đến việc không tương thích giữa phương tiện vận chuyển và xe, thì trường này sẽ cung cấp chỉ mục của một xe có liên quan.

Timestamp

Thời gian bắt đầu của khung thời gian cố định. Nếu không được chỉ định, giá trị này sẽ được đặt thành ShipmentModel.global_start_time.

Timestamp

Thời gian kết thúc của khung thời gian bắt buộc. Nếu không được chỉ định, giá trị này sẽ được đặt thành ShipmentModel.global_end_time.

Timestamp

Thời gian bắt đầu mềm của khoảng thời gian.

Timestamp

Thời gian kết thúc mềm của khung thời gian.

double

Chi phí mỗi giờ được thêm vào các chi phí khác trong mô hình nếu sự kiện xảy ra trước soft_start_time, được tính như sau:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

Chi phí này phải là số dương và bạn chỉ có thể đặt trường này nếu đã đặt soft_start_time.

double

Chi phí mỗi giờ được thêm vào các chi phí khác trong mô hình nếu sự kiện xảy ra sau soft_end_time, được tính như sau:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

Chi phí này phải là số dương và bạn chỉ có thể đặt trường này nếu đã đặt soft_end_time.

string

Thẻ xác định tập hợp các chuyển đổi (src->dst) mà các thuộc tính này áp dụng.

Một lượt truy cập nguồn hoặc lượt khởi động xe sẽ khớp nếu VisitRequest.tags hoặc Vehicle.start_tags của lượt truy cập đó chứa src_tag hoặc không chứa excluded_src_tag (tuỳ thuộc vào việc hai trường này có trống hay không).

string

Vui lòng xem src_tag. Phải có đúng một trong src_tag và excluded_src_tag không được để trống.

string

Lượt truy cập đích hoặc điểm kết thúc của xe sẽ khớp nếu VisitRequest.tags hoặc Vehicle.end_tags chứa dst_tag hoặc không chứa excluded_dst_tag (tuỳ thuộc vào việc hai trường này có trống hay không).

string

Vui lòng xem dst_tag. Phải có đúng một trong dst_tag và excluded_dst_tag không được để trống.

double

Chỉ định chi phí để thực hiện quá trình chuyển đổi này. Giá trị này có cùng đơn vị với tất cả các chi phí khác trong mô hình và không được âm. Khoản phí này được áp dụng ngoài tất cả các chi phí hiện có khác.

double

Chỉ định chi phí trên mỗi km áp dụng cho quãng đường đã đi trong khi thực hiện quá trình chuyển đổi này. Giá trị này cộng với mọi Vehicle.cost_per_kilometer được chỉ định trên xe.

DistanceLimit

Chỉ định giới hạn về quãng đường đã đi trong khi thực hiện quá trình chuyển đổi này.

Kể từ tháng 6 năm 2021, chúng tôi chỉ hỗ trợ các giới hạn mềm.

Duration

Chỉ định độ trễ phát sinh khi thực hiện quá trình chuyển đổi này.

Độ trễ này luôn xảy ra sau khi kết thúc lượt truy cập nguồn và trước khi bắt đầu lượt truy cập đích.

string

Tên hiển thị do người dùng xác định của xe. Tên này có thể dài tối đa 63 ký tự và có thể sử dụng ký tự UTF-8.

TravelMode

Chế độ di chuyển ảnh hưởng đến những con đường mà xe có thể đi và tốc độ của xe. Xem thêm travel_duration_multiple.

RouteModifiers

Một nhóm điều kiện cần đáp ứng ảnh hưởng đến cách tính tuyến đường cho một loại xe nhất định.

LatLng

Vị trí địa lý nơi xe bắt đầu trước khi nhận bất kỳ lô hàng nào. Nếu không được chỉ định, xe sẽ bắt đầu ở lần lấy hàng đầu tiên. Nếu mô hình lô hàng có ma trận thời lượng và khoảng cách, thì bạn không được chỉ định start_location.

Waypoint

Điểm trung gian thể hiện vị trí địa lý nơi xe bắt đầu trước khi nhận bất kỳ lô hàng nào. Nếu bạn không chỉ định start_waypoint hoặc start_location, thì xe sẽ bắt đầu ở lần lấy hàng đầu tiên. Nếu mô hình lô hàng có ma trận thời lượng và khoảng cách, thì bạn không được chỉ định start_waypoint.

LatLng

Vị trí địa lý nơi xe kết thúc sau khi hoàn tất VisitRequest cuối cùng. Nếu bạn không chỉ định, ShipmentRoute của xe sẽ kết thúc ngay khi hoàn tất VisitRequest cuối cùng. Nếu mô hình lô hàng có ma trận thời lượng và khoảng cách, thì bạn không được chỉ định end_location.

Waypoint

Điểm trung gian thể hiện vị trí địa lý mà xe kết thúc sau khi hoàn thành VisitRequest cuối cùng. Nếu bạn không chỉ định end_waypoint hoặc end_location, thì ShipmentRoute của xe sẽ kết thúc ngay lập tức khi hoàn tất VisitRequest cuối cùng. Nếu mô hình lô hàng có ma trận thời lượng và khoảng cách, thì bạn không được chỉ định end_waypoint.

string

Chỉ định các thẻ được đính kèm vào điểm bắt đầu của tuyến đường của xe.

Không được phép sử dụng chuỗi trống hoặc trùng lặp.

string

Chỉ định các thẻ được đính kèm vào cuối tuyến đường của xe.

Không được phép sử dụng chuỗi trống hoặc trùng lặp.

TimeWindow

Khung thời gian mà xe có thể rời khỏi vị trí bắt đầu. Các giá trị này phải nằm trong giới hạn thời gian chung (xem các trường ShipmentModel.global_*). Nếu không được chỉ định, thì sẽ không có giới hạn nào ngoài các giới hạn thời gian chung đó.

Các khoảng thời gian thuộc cùng một trường định kỳ phải tách biệt, tức là không có khoảng thời gian nào được trùng lặp hoặc liền kề với khoảng thời gian khác, đồng thời các khoảng thời gian này phải theo thứ tự thời gian.

Bạn chỉ có thể đặt cost_per_hour_after_soft_end_time và soft_end_time nếu có một khoảng thời gian duy nhất.

TimeWindow

Khoảng thời gian mà xe có thể đến vị trí cuối cùng. Các giá trị này phải nằm trong giới hạn thời gian chung (xem các trường ShipmentModel.global_*). Nếu không được chỉ định, thì sẽ không có giới hạn nào ngoài các giới hạn thời gian chung đó.

Các khoảng thời gian thuộc cùng một trường định kỳ phải tách biệt, tức là không có khoảng thời gian nào được trùng lặp hoặc liền kề với khoảng thời gian khác, đồng thời các khoảng thời gian này phải theo thứ tự thời gian.

Bạn chỉ có thể đặt cost_per_hour_after_soft_end_time và soft_end_time nếu có một khoảng thời gian duy nhất.

UnloadingPolicy

Chính sách về việc dỡ hàng được thực thi trên xe.

map<string, LoadLimit>

Sức chứa của xe (ví dụ: trọng lượng, thể tích, số lượng pallet). Các khoá trong bản đồ là giá trị nhận dạng của loại tải, nhất quán với các khoá của trường Shipment.load_demands. Nếu một khoá nhất định không có trong bản đồ này, thì dung lượng tương ứng được coi là không giới hạn.

double

Chi phí xe: tất cả chi phí cộng lại và phải có cùng đơn vị với Shipment.penalty_cost.

Chi phí mỗi giờ của tuyến xe. Chi phí này được áp dụng cho tổng thời gian của tuyến đường, bao gồm thời gian di chuyển, thời gian chờ và thời gian ghé thăm. Việc sử dụng cost_per_hour thay vì chỉ cost_per_traveled_hour có thể làm tăng độ trễ.

double

Chi phí mỗi giờ di chuyển của tuyến đường xe. Chi phí này chỉ áp dụng cho thời gian di chuyển theo tuyến đường (tức là thời gian được báo cáo trong ShipmentRoute.transitions) và không bao gồm thời gian chờ và thời gian ghé thăm.

double

Chi phí mỗi km trên tuyến đường của xe. Chi phí này được áp dụng cho khoảng cách được báo cáo trong ShipmentRoute.transitions và không áp dụng cho bất kỳ khoảng cách nào được di chuyển ngầm từ arrival_location đến departure_location của một VisitRequest.

double

Chi phí cố định được áp dụng nếu xe này được dùng để xử lý một lô hàng.

bool

Trường này chỉ áp dụng cho các xe khi tuyến đường của xe không phục vụ bất kỳ lô hàng nào. Giá trị này cho biết liệu xe có được coi là đã qua sử dụng hay không trong trường hợp này.

Nếu đúng, xe sẽ đi từ vị trí bắt đầu đến vị trí kết thúc ngay cả khi không phục vụ bất kỳ lô hàng nào, đồng thời tính đến thời gian và chi phí khoảng cách phát sinh từ việc di chuyển từ vị trí bắt đầu đến vị trí kết thúc.

Nếu không, xe sẽ không di chuyển từ vị trí bắt đầu đến vị trí kết thúc và không có break_rule hoặc độ trễ (từ TransitionAttributes) nào được lên lịch cho xe này. Trong trường hợp này, ShipmentRoute của xe không chứa bất kỳ thông tin nào ngoại trừ chỉ mục và nhãn xe.

DurationLimit

Giới hạn áp dụng cho tổng thời lượng của tuyến đường của xe. Trong một OptimizeToursResponse nhất định, thời lượng tuyến đường của một xe là chênh lệch giữa vehicle_end_time và vehicle_start_time của xe đó.

DurationLimit

Giới hạn áp dụng cho thời gian di chuyển của tuyến đường của xe. Trong một OptimizeToursResponse nhất định, thời gian di chuyển theo tuyến đường là tổng của tất cả transitions.travel_duration.

DistanceLimit

Giới hạn áp dụng cho tổng quãng đường của tuyến đường của xe. Trong một OptimizeToursResponse nhất định, quãng đường của tuyến đường là tổng của tất cả transitions.travel_distance_meters.

map<string, Duration>

Chỉ định một bản đồ từ các chuỗi visit_types đến thời lượng. Thời lượng là thời gian cộng với VisitRequest.duration cần được thực hiện trong các lượt truy cập có visit_types được chỉ định. Thời lượng truy cập bổ sung này sẽ làm tăng chi phí nếu bạn chỉ định cost_per_hour. Khoá (tức là visit_types) không được là chuỗi trống.

Nếu một yêu cầu truy cập có nhiều loại, thì thời lượng sẽ được thêm cho từng loại trong bản đồ.

BreakRule

Mô tả lịch nghỉ sẽ được thực thi trên xe này. Nếu trống, xe này sẽ không được lên lịch nghỉ.

string

Chỉ định nhãn cho xe này. Nhãn này được báo cáo trong phản hồi dưới dạng vehicle_label của ShipmentRoute tương ứng.

bool

Nếu đúng, used_if_route_is_empty phải là sai và xe này sẽ không được sử dụng.

Nếu một lô hàng được thực hiện bằng một xe bị bỏ qua trong injected_first_solution_routes, thì lô hàng đó sẽ bị bỏ qua trong giải pháp đầu tiên nhưng có thể được thực hiện trong phản hồi.

Nếu một lô hàng được thực hiện bằng một xe bị bỏ qua trong injected_solution_constraint và mọi hoạt động lấy hàng/giao hàng có liên quan bị ràng buộc phải vẫn trên xe (tức là không được nới lỏng đến cấp RELAX_ALL_AFTER_THRESHOLD), thì lô hàng đó sẽ bị bỏ qua trong phản hồi. Nếu một lô hàng có trường allowed_vehicle_indices không trống và tất cả các phương tiện được phép đều bị bỏ qua, thì lô hàng đó sẽ bị bỏ qua trong phản hồi.

double

Chỉ định hệ số nhân có thể dùng để tăng hoặc giảm thời gian di chuyển của phương tiện này. Ví dụ: việc đặt giá trị này thành 2.0 có nghĩa là xe này chạy chậm hơn và có thời gian di chuyển gấp đôi so với xe tiêu chuẩn. Hệ số này không ảnh hưởng đến thời lượng truy cập. Giá trị này ảnh hưởng đến chi phí nếu bạn chỉ định cost_per_hour hoặc cost_per_traveled_hour. Giá trị này phải nằm trong phạm vi [0,001, 1000]. Nếu bạn không đặt giá trị, thì xe sẽ là xe tiêu chuẩn và hệ số này được coi là 1.0.

CẢNH BÁO: Thời gian di chuyển sẽ được làm tròn đến giây gần nhất sau khi áp dụng bội số này nhưng trước khi thực hiện bất kỳ phép toán số nào. Do đó, một bội số nhỏ có thể làm giảm độ chính xác.

Xem thêm extra_visit_duration_for_visit_type bên dưới.

Duration

Giới hạn cứng ràng buộc thời lượng tối đa là max_duration.

Duration

Giới hạn mềm không thực thi giới hạn thời lượng tối đa, nhưng khi bị vi phạm sẽ khiến tuyến phải chịu chi phí. Chi phí này cộng với các chi phí khác được xác định trong mô hình, với cùng một đơn vị.

Nếu được xác định, soft_max_duration phải là số không âm. Nếu bạn cũng xác định max_duration, thì soft_max_duration phải nhỏ hơn max_duration.

Duration

Giới hạn mềm không thực thi giới hạn thời lượng tối đa, nhưng khi bị vi phạm, tuyến đường sẽ phải chịu một chi phí, theo hàm bậc hai trong thời lượng. Chi phí này cộng với các chi phí khác được xác định trong mô hình, với cùng một đơn vị.

Nếu được xác định, quadratic_soft_max_duration phải là số không âm. Nếu max_duration cũng được xác định, thì quadratic_soft_max_duration phải nhỏ hơn max_duration và chênh lệch không được lớn hơn một ngày:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Chi phí mỗi giờ phát sinh nếu vi phạm ngưỡng soft_max_duration. Chi phí bổ sung là 0 nếu thời lượng dưới ngưỡng, nếu không, chi phí sẽ phụ thuộc vào thời lượng như sau:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Chi phí phải là số không âm.

double

Chi phí mỗi giờ vuông phát sinh nếu vi phạm ngưỡng quadratic_soft_max_duration.

Chi phí bổ sung là 0 nếu thời lượng dưới ngưỡng, nếu không, chi phí sẽ phụ thuộc vào thời lượng như sau:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Chi phí phải là số không âm.

int64

Giới hạn linh hoạt của tải. Vui lòng xem cost_per_unit_above_soft_max.

double

Nếu tải vượt quá soft_max_load dọc theo tuyến đường của xe này, thì mức phạt chi phí sau đây sẽ được áp dụng (chỉ một lần cho mỗi xe): (tải – soft_max_load) * cost_per_unit_above_soft_max. Tất cả các chi phí đều được cộng lại và phải có cùng đơn vị với Shipment.penalty_cost.

Interval

Khoảng thời gian tải chấp nhận được của xe ở đầu tuyến.

Interval

Khoảng thời gian tải chấp nhận được của xe ở cuối tuyến.

int64

Mức tải tối đa được chấp nhận.

int64

Mức tải tối thiểu chấp nhận được. Phải ≥ 0. Nếu cả hai đều được chỉ định, min phải ≤ max.

int64

Mức tải tối đa chấp nhận được. Phải ≥ 0. Nếu không được chỉ định, tải tối đa sẽ không bị hạn chế bởi thông báo này. Nếu cả hai đều được chỉ định, min phải ≤ max.

bool

Không bắt buộc. Cho biết vị trí của điểm trung gian này là để ưu tiên xe dừng ở một bên đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí đó để xe có thể dừng ở bên đường mà vị trí đó nghiêng về phía trung tâm đường. Tuỳ chọn này không hoạt động với chế độ đi bộ.

Location

Một điểm được chỉ định bằng toạ độ địa lý, bao gồm cả tiêu đề không bắt buộc.

string

Mã địa điểm POI được liên kết với điểm trung gian.