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 lấy hàng và giao hàng 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 giải pháp.

Duration

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

Duration

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

Duration

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

Duration

Tổng thời lượng truy cập cho một tuyến đường hoặc 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, tham số 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 trọng tối đa đạt được trên toàn bộ tuyến đường (giải pháp tương ứng), cho từng số lượng trên tuyến đường (giải pháp tương ứng) này, được tính là giá trị tối đa trên tất cả Transition.vehicle_loads (giải pháp tương ứng ShipmentRoute.metrics.max_loads.

int32

Số lượng lô hàng bắt buộc đã thực hiện.

Thử nghiệm: Hành vi hoặc sự tồn tại của trường này có thể thay đổi trong tương lai.

double

Tổng Shipment.penalty_cost của các lô hàng đã thực hiện.

Thử nghiệm: Hành vi hoặc sự tồn tại của trường này có thể thay đổi trong tương lai.

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 mua hàng, 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ẫu do người dùng xác định, người dùng có thể sử dụng tên này làm biệt hiệu để theo dõi các mẫu.

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 đoạn nghỉ. 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 đáp ứng trước ngày BreakRequest của BreakRule. Hãy xem FrequencyConstraint.

Timestamp

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

Timestamp

Bắt buộc. Giới hạn trên (bao gồm) của thời điểm bắt đầu khoảng thời gian ngắt.

Duration

Bắt buộc. Thời lượng tối thiểu của khoảng thời gian nghỉ. Phải là số dương.

Duration

Bắt buộc. Thời lượng nghỉ tối thiểu 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ỉ ngơi là duration >= min_break_duration. Phải là số dương.

int64

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

int64

Giới hạn mềm không áp dụng giới hạn khoảng cách tối đa, nhưng khi bị vi phạm, giới hạn này sẽ dẫn đến một chi phí cộng thêm vào 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í phát sinh trên mỗi km, 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.

route_distance_limit không hỗ trợ chi phí này.

double

Chi phí trên mỗi km phát sinh nếu khoảng cách vượt quá giới hạn 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í là:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Chi phí không được là số â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 cơ bản về tính hợp lệ được liệt kê cho injected_first_solution_routes.

SkippedShipment

Các lô hàng bị bỏ qua 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 0 hoặc nhiều nhóm xe, hãy chỉ định thời điểm và mức độ nới lỏng các ràng buộc. Nếu trường này trống, thì tất cả các tuyến đường không trống của xe đều bị hạn chế hoàn toàn.

Relaxation

Tất cả các quy tắc nới lỏng về lượt ghé thăm sẽ áp dụng cho các lượt ghé thăm trên những tuyến đường có phương tiện trong vehicle_indices.

int32

Chỉ định chỉ mục xe mà quy tắc ràng buộc lượt truy cập relaxations áp dụng. Nếu bạn để trống, thì đây được coi là giá trị mặc định và relaxations sẽ áp dụng cho tất cả những chiếc xe 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à bạn chỉ được phép để trống tối đa một trường nới lỏng ràng buộc vehicle_indices. Bạn chỉ có thể đăng một chỉ mục xe, ngay cả trong nhiều 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à true (xem chú thích fields).

Level

Mức độ nới lỏng 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 mà bạn có thể áp dụng quy tắc nới lỏng level.

int32

Số lượt truy cập mà sau đó có thể áp dụng quy tắc nới lỏng level. 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 bắt đầu khởi động.

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

DataFormat

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

GcsSource

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

LatLng

Toạ độ địa lý của điểm đánh dấu.

int32

Hướng la bàn liên quan đến hướng lưu lượng truy cập. Giá trị này dùng để chỉ định phía đường cần sử dụng để đón và trả khách. Giá trị hướng có thể từ 0 đến 360, trong đó 0 chỉ định hướng Bắc, 90 chỉ định hướng Đông, v.v.

string

Bắt buộc. Nhắm đến dự án hoặc vị trí cần 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ề một phản hồi trước khi hết thời gian chờ hoặc đạt đến 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 trước.

Đối với các yêu cầu không đồng bộ, máy chủ sẽ tạo ra 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 được 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ư một giải pháp trước đó.

Mô hình bị hạn chế khi giải pháp đầu tiên được xây dựng. Mọi lô hàng không được thực hiện trên một tuyến đường sẽ bị bỏ qua một cách ngầm định 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 đường, vehicle_index phải nằm trong phạm vi và không được trùng lặp.
• đối với tất cả các lượt truy cập, shipment_index và visit_request_index phải nằm trong phạm vi.
• bạn chỉ có thể tham chiếu một lô hàng trên một tuyến đường.
• bạn phải đến lấy hàng của lô hàng đến lấy và giao trước khi giao hàng.
• bạn chỉ có thể thực hiện tối đa một lựa chọn thay thế cho việc tự đến lấy hoặc giao hàng của một lô hàng.
• đối với tất cả các tuyến đường, thời gian đều tăng lên (tức là vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• bạn chỉ có thể vận chuyển bằng phương tiện được phép. Bạn được phép sử dụng một chiếc xe nếu Shipment.allowed_vehicle_indices trống hoặc vehicle_index của chiếc xe đó có 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à thay vào đó, có thể trả về lỗi cho biết giải pháp không khả thi.

InjectedSolutionConstraint

Hạn chế thuật toán tối ưu hoá để tìm ra giải pháp cuối cùng tương tự như một giải pháp trước đó. Ví dụ: bạn có thể dùng cách này để cố định những phần của tuyến đường đã hoàn thành hoặc sẽ hoàn thành nhưng không được phép 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à thay vào đó, có thể trả về lỗi cho biết giải pháp 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ự cơ bản của các lượt truy cập hoặc thời gian di chuyển: chỉ các thông tin khác sẽ được cập nhật. Thao tác này không giải quyết được mô hình.

Kể từ ngày 11/2020, phương thức này chỉ điền sẵn các đường nhiều đoạn của những tuyến đường không trống và yêu cầu populate_polylines là true.

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

Bạn 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. Đường nhiều đoạn vẫn được điền sẵn giữa tất cả các lượt ghé thăm trong mọi tuyến đường không trống, bất kể các lô hàng hoặc xe có 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 đường trong một 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 lượt truy cập trong một 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 theo 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 tham số 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á hoặc thêm vào yêu cầu.

Nếu là true, nhãn trong các danh mục sau đây chỉ được 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 tiêm;
• 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, có 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 ghé thăm. Nếu shipment_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ì 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 ghé thăm tuyến đường hoặc toàn bộ tuyến đường khỏi một giải pháp được chèn có thể ảnh hưởng đến các ràng buộc ngầm định, điều này 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 mỗi Vehicle.label (tương ứng. Shipment.label) xác định duy nhất một thực thể xe (tương ứng là lô hàng) được dùng trong 2 yêu cầu có liên quan: yêu cầu trước đó đã tạo ra OptimizeToursResponse được dùng trong giải pháp được chèn và yêu cầu hiện tại có chứa giải pháp được chèn. Các bước kiểm tra tính duy nhất nêu trên là không đủ để đả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 nhiều đoạn sẽ được điền sẵn trong các phản hồi ShipmentRoute.

bool

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

bool

Nếu được đặt, 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 dài có nguy cơ bị gián đoạn cao hơn đáng kể (nhưng vẫn nhỏ).

bool

Nếu đúng, khoảng cách 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, còn 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ể 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 độ được áp dụng để tính thời gian di chuyển. Giá trị của thông số này ít nhất phải là 1,0 mét/giây.

int32

Cắt bớt số lượng lỗi xác thực được trả về. Những lỗi này thường được đính kèm vào 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ừ phi solving_mode=VALIDATE_ONLY: xem trường OptimizeToursResponse.validation_errors. Giá trị mặc định là 100 và giới hạn là 10.000.

ShipmentRoute

Các tuyến đường được tính toán cho từng 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 một 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ả cá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 phần giải thích "NHIỀU LỖI" cho thông báo OptimizeToursValidationError. Thay vì lỗi, trường hợp này sẽ bao gồm cả cảnh báo nếu solving_mode là DEFAULT_SOLVE.

OptimizeToursRequest

Trong một số trường hợp, chúng tôi sửa đổi yêu cầu nhận được trước khi giải quyết, tức là thêm chi phí. Nếu solving_mode == TRANSFORM_AND_RETURN_REQUEST, thì yêu cầu đã sửa đổi sẽ được trả về tại đây.

Thử nghiệm: Xem https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request để biết thêm thông tin chi tiết.

Metrics

Thời lượng, khoảng cách và chỉ số sử dụng cho giải pháp này.

AggregatedMetrics

Dữ liệu được 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 đường của 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 cho một chiếc xe đã qua sử dụng, được tính là thời gian tối thiểu của tất cả các xe đã qua sử dụng là ShipmentRoute.vehicle_start_time.

Timestamp

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

map<string, double>

Chi phí của giải pháp, được chia nhỏ 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 của tất cả chi phí lấy hàng trong 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 (Thuộc tính chuyển đổi) 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í.

string

Bắt buộc. Nhắm đến dự án hoặc vị trí cần 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.

Uri

Bắt buộc. URI của đối tượng Cloud Storage chứa OptimizeToursRequest.

Uri

Bắt buộc. URI của đối tượng Cloud Storage sẽ chứa OptimizeToursResponse.

Uri

Không bắt buộc. URI của đối tượng Cloud Storage chứa OptimizeToursResponse được mã hoá dưới dạng JSON hoặc textproto. Nếu đối tượng được mã hoá dưới dạng JSON, thì phần mở rộng của tên đối tượng sẽ là .json. Nếu đối tượng được mã hoá dưới dạng textproto, thì phần mở rộng của tên đối tượng sẽ là .txtpb.

Bạn có thể dùng crc32_checksum của tài nguyên để xác minh nội dung của tài nguyên chưa bị sửa đổi.

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 bối cảnh về lỗi.

NHIỀU LỖI: Khi có nhiều lỗi, quy trình xác thực sẽ cố gắng xuất một số lỗi trong số đó. Giống 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à "nghiêm trọng", tức là những lỗi này sẽ dừng toàn bộ quy trình xác thực. Đây là trường hợp đối với lỗi display_name="UNSPECIFIED", trong số những lỗi khác. Một số lỗi có thể khiến quy 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, 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 nhất định (không hợp lệ) tạo ra một cặp (code, display_name) khác vì lỗi mới đã ẩn lỗi cũ. Ví dụ: xem "NHIỀU LỖI".

string

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

FieldReference

Bối cảnh lỗi có thể liên quan đến 0, 1 (hầu hết thời gian) hoặc nhiều trường. Ví dụ: bạn có thể tham khảo lần nhận hàng đầu tiên của xe số 4 và lô hàng số 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 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 mã != "UNSPECIFIED").

ĐỘ Ổ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 (hy vọng là để làm rõ) theo thời gian. Thay vào đó, vui lòng dựa vào 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ó sẵn. Bạn tuyệt đối không nên dựa vào thông tin này và chỉ sử dụng cho mục đích gỡ lỗi mô hình theo cách thủ công.

string

Tên của 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 được 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í của Google Cloud Storage để ghi đầu ra.

bool

Chỉ định có nên tránh đường thu phí nếu có thể hay không. Chúng tôi sẽ ưu tiên những tuyến đường không có đường thu phí. Chỉ áp dụng cho các chế độ 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 có thể). Các tuyến đường không có đường cao tốc sẽ được ưu tiên. Chỉ áp dụng cho các chế độ di chuyển bằng động cơ.

bool

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

bool

Không bắt buộc. Chỉ định có nên tránh điều hướng trong nhà khi hợp lý hay không. Các tuyến đường không có chỉ dẫn điều hướng trong nhà sẽ được ưu tiên. Chỉ áp dụng cho chế độ di chuyển 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 các ký tự UTF-8.

VisitRequest

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

VisitRequest

Tập hợp các lựa chọn thay thế về việc giao hàng liên quan đến lô hàng. Nếu không được chỉ định, xe chỉ cần ghé thăm một vị trí tương ứng với các điểm đón.

map<string, Load>

Nhu cầu tải của lô hàng (ví dụ: trọng lượng, thể tích, số lượng pallet, v.v.). Các khoá trong bản đồ phải là giá trị nhận dạng mô tả loại tải tương ứng, lý tưởng nhất là cũng bao gồm cá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 chuyến vận chuyển này. Nếu bạn để trống, tất cả các phương tiện đều có thể thực hiện thao tác này. Phương tiện được cung cấp theo chỉ mục trong danh sách ShipmentModel của vehicles.

double

Cho biết chi phí phát sinh khi mỗi chiếc xe giao lô hàng này. Nếu được chỉ định, thì giá trị này PHẢI có MỘT TRONG HAI:

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

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

int32

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

Duration

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

Ví dụ: giả sử t là thời gian ngắn nhất để đi từ địa điểm tự đến lấy đã chọn đến địa điểm giao hàng đã chọn. Sau đó, chế độ cài đặt 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à tuyệt đối đều được chỉ định trên cùng một lô hàng, thì giới hạn ràng buộc hơn sẽ được sử dụng cho mỗi cặp nhận hàng/giao hàng có thể có. Kể từ ngày 10/2017, chúng tôi chỉ hỗ trợ đường vòng khi thời gian di chuyển không phụ thuộc vào phương tiện.

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 không âm và lô hàng phải có ít nhất một lần đến lấy và một lần giao hàng. Điều này không phụ thuộc vào lựa chọn thay thế nào được chọn để lấy hàng và giao hàng, cũng như tốc độ của xe. Bạn có thể chỉ định thông số này cùng với các ràng buộc tối đa về đường vòng: 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 một "type" cho lô hàng này. Bạn có thể dùng tính năng này để xác định các điểm không tương thích hoặc yêu cầu 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ần ghé thăm: Tất cả các lần nhận 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 chuyến giao hàng được thực hiện trong injected_first_solution_routes hoặc injected_solution_constraint; trình giải quyết sẽ xoá các lượt ghé thăm liên quan để lấy/giao hàng 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 chưa hoàn tất việc vận chuyển, khoản tiền phạt này sẽ được cộng vào tổng chi phí của các tuyến đường. Một chuyến hàng được coi là hoàn tất nếu bạn truy cập vào một trong các lựa chọn thay thế về việc đến lấy hàng và giao hàng. Bạn có thể biểu thị chi phí bằng cùng đơ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.

QUAN TRỌNG: Nếu bạn không chỉ định mức phạt này, thì mức phạt sẽ được coi là vô hạn, tức là bạn phải hoàn tất việc vận chuyển.

double

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

Ví dụ: giả sử t là thời gian ngắn nhất để đi từ địa điểm tự đến lấy đã chọn đến địa điểm giao hàng đã chọn. Sau đó, chế độ cài đặt 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à tuyệt đối đều được chỉ định trên cùng một lô hàng, thì giới hạn ràng buộc hơn sẽ được sử dụng cho mỗi cặp nhận hàng/giao hàng có thể có. Kể từ ngày 10/2017, chúng tôi chỉ hỗ trợ đường vòng khi thời gian di chuyển không phụ thuộc vào phương tiện.

int64

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

LatLng

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

Waypoint

Điểm tham chiếu mà xe đến khi thực hiện VisitRequest này. Nếu mô hình vận chuyển có ma trận khoảng cách về 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 thành VisitRequest này. Bạn có thể bỏ qua nếu URL này giống với arrival_location. Nếu mô hình vận chuyển có ma trận khoảng cách về thời gian, bạn không được chỉ định departure_location.

Waypoint

Điểm tham chiếu nơi phương tiện khởi hành sau khi hoàn thành VisitRequest này. Bạn có thể bỏ qua nếu URL này giống với arrival_waypoint. Nếu mô hình vận chuyển có ma trận khoảng cách về thời gian, bạn không được chỉ định departure_waypoint.

string

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

TimeWindow

Khung thời gian giới hạn thời gian đến của một lượt truy cập. Xin lưu ý rằng xe có thể khởi hành bên ngoài khung thời gian đến, tức là thời gian đến + thời lượng không cần nằm trong một khung 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, tức là xe có thể thực hiện chuyến ghé thăm này bất cứ lúc nào.

Các khung thời gian phải rời rạc, tức là không có khung thời gian nào được chồng chéo hoặc liền kề với khung thời gian khác và các khung thời gian phải 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 chỉ có một khung thời gian.

Duration

Thời gian của chuyến ghé thăm, tức là thời gian mà xe đã dành ra giữa thời điểm đến và thời điểm rời đi (sẽ được thêm vào thời gian chờ có thể có; xem time_windows).

double

Chi phí để phục vụ yêu cầu ghé thăm này trên một tuyến đường của xe. Bạn có thể sử dụng thuộc tính này để thanh toán các khoản phí khác nhau cho từng lựa chọn thay thế để đến lấy hàng hoặc giao hàng của một lô hàng. Chi phí này phải có cùng đơn vị với Shipment.penalty_cost và không được là số â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 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ê tại đây sẽ đượ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ể dùng thông tin này để phân bổ thêm thời gian cần thiết cho xe hoàn tất chuyến thăm này (xem Vehicle.extra_visit_duration_for_visit_type).

Mỗi 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.

bool

Chỉ định xem có nên tránh quay đầu xe trong các tuyến đường lái xe tại vị trí này hay không. Tính năng tránh quay đầu xe sẽ cố gắng hết sức để hoạt động và không đảm bảo tránh hoàn toàn. Đây là một tính năng thử nghiệm và hành vi của tính năng này có thể thay đổi.

Thử nghiệm: Xem https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request để biết thêm thông tin chi tiết.

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 phương tiện có thể dùng để thực hiện chuyến thăm.

Objective

Tập hợp các mục tiêu cho mô hình này mà chúng ta sẽ chuyển đổi thành chi phí. Nếu không trống, mô hình đầu vào phải không tốn kém. Để nhận được yêu cầu đã sửa đổi, vui lòng sử dụng solving_mode = TRANSFORM_AND_RETURN_REQUEST. Xin lưu ý rằng yêu cầu sẽ không được giải quyết trong trường hợp này. Xem tài liệu tương ứng.

Thử nghiệm: Xem https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request để biết thêm thông tin chi tiết.

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 bên 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 cho ngày đó). Nếu bạn không đặt, hệ thống sẽ dùng 00:00:00 UTC, ngày 1 tháng 1 năm 1970 (tức là giây: 0, nano giây: 0) làm giá trị mặc định.

Timestamp

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

double

"Thời lượng tổng thể" của kế hoạch tổng thể là khoảng thời gian 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ả các phương tiện. 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, chẳng hạn như vậy. Chi phí này phải có cùng đơn vị với Shipment.penalty_cost.

DurationDistanceMatrix

Chỉ định ma trận khoảng thời gian và khoảng cách được 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 dùng thay thế, 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 thể là true và cả duration_distance_matrix_src_tags lẫn duration_distance_matrix_dst_tags đều không thể 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 "fast".
• 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 "slow".
• 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 "fast".
• 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

Các 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 ghé thăm có thẻ duration_distance_matrix_src_tags(j) đến các lượt ghé thăm khác trong ma trận i.

Các 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, thẻ đích và thẻ ma trận của Vehicle có thể giống nhau; tương tự, thẻ nguồn và thẻ đích của VisitRequest có thể giống nhau. Tất cả cá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ừ lượt truy cập có thẻ duration_distance_matrix_src_tags(j) đến lượt truy cập có thẻ duration_distance_matrix_dst_tags(k) trong ma trận i.

Các 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, thẻ đích và thẻ ma trận của Vehicle có thể giống nhau; tương tự, thẻ nguồn và thẻ đích của VisitRequest có thể giống nhau. Tất cả cá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 nhóm shipment_type không tương thích (xem ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Bộ 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.

QUAN TRỌNG: Việc sử dụng các quy tắc ưu tiên sẽ giới hạn quy mô của vấn đề có thể được tối ưu hoá. Các yêu cầu sử dụng quy tắc thứ tự ưu tiên bao gồm nhiều lô hàng có thể bị từ chối.

int32

Hạn chế số lượng tối đa các phương tiện đ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 giao hàng. Bạn có thể dùng tham số này để giới hạn số lượng tuyến đường 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 đó, quá trình tối ưu hoá sẽ chọn nhóm nhỏ gồm những chiếc 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 khoảng thời gian và khoảng cách. Phần tử này phải có số lượng phần tử bằng với ShipmentModel.duration_distance_matrix_src_tags.

string

Thẻ xác định những chiếc xe mà ma trận khoảng thời gian và khoảng cách này áp dụng. Nếu bạn để trống trường này, thì quy tắc này sẽ áp dụng cho tất cả các phương tiện và chỉ có thể có một ma trận.

Mỗi điểm bắt đầu của 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 điểm bắt đầu đó phải khớp với vehicle_start_tag của một ma trận (và chỉ 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. Phần tử này phải có số lượng phần tử bằng với 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 ràng buộc nào đề cập đến khoảng cách trong mô hình, thì bạn có thể để trống trường này; nếu không, trường này phải có số lượng phần tử bằng với durations.

Type

Loại mục tiêu.

double

Mức độ quan trọng của mục tiêu này so với các mục tiêu khác. Đây có thể là bất kỳ số không âm nào, trọng số không nhất thiết phải có tổng bằng 1. Trọng số mặc định là 1.0.

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". Điều này có thể gây ảnh hưởng tiêu cực.

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 trong ShipmentModel nguồn.

string

Nhãn của xe thực hiện tuyến đường này, bằng với 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 mà xe hoàn thành tuyến đường.

Visit

Trình tự có thứ tự của các lượt ghé thăm đại diện cho một tuyến đường. visits[i] là lượt ghé thăm thứ i trong tuyến đường. Nếu trường này trống, thì xe được coi là chưa sử dụng.

Transition

Danh sách các hiệu ứng chuyển cảnh 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 của 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 tình trạng giao thông. Có thể không đủ thời gian để hoàn thành chuyến đi có điều chỉnh lưu lượng truy cập, thời gian trễ và khoảng thời gian nghỉ giữa các lượt ghé thăm, trước lượt ghé thăm đầu tiên hoặc sau lượt ghé thăm cuối cùng, trong khi vẫn đáp ứng được khung thời gian của lượt ghé thăm và xe. Ví dụ:

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

Thời gian đến tại next_visit có thể sẽ muộn hơn so với khung thời gian hiện tại do thời gian di chuyển ước tính tăng lên travel_duration(previous_visit, next_visit) do tình trạng giao thông. Ngoài ra, thời gian nghỉ có thể bị buộc phải trùng với thời gian ghé thăm do thời gian di chuyển ước tính tăng lên và các hạn chế về khung thời gian ghé thăm hoặc nghỉ ngơi.

EncodedPolyline

Biểu thị hình nhiều đường được mã hoá của tuyến đường. Trường này chỉ được điền sẵn nếu bạn đặt OptimizeToursRequest.populate_polylines thành true.

Break

Thời gian nghỉ được lên 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

Chỉ số về thời lượng, khoảng cách và tải trọng 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 bối cảnh.

VehicleFullness

trường VehicleFullness để tính toán mức độ gần của các chỉ số bị giới hạn so với giới hạn tương ứng của xe. Các trường của chỉ số này là tỷ lệ giữa một trường chỉ số có giới hạn (ví dụ: AggregatedMetrics.travel_distance_meters) và giới hạn liên quan của xe (ví dụ: Vehicle.route_distance_limit).

Thử nghiệm: Hành vi hoặc sự tồn tại của trường này có thể thay đổi trong tương lai.

map<string, double>

Chi phí của tuyến đường, được chia nhỏ 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ộ tuyến đường. Nói cách khác, costs["model.shipments.pickups.cost"] là tổng của tất cả 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 (Thuộc tính chuyển đổi) 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 của tất cả các chi phí trong bản đồ chi phí.

Timestamp

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

Duration

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

string

Chuỗi biểu thị các điểm được mã hoá của đường nhiều đoạ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, thì giá trị boolean này được đặt thành true. Đây có thể là sự cố tạm thời (sự cố hiếm gặp trong máy chủ lưu lượng truy cập theo thời gian thực) hoặc sự cố vĩnh viễn (không có dữ liệu cho vị trí này).

Duration

Tổng thời lượng trễ được áp dụng cho hiệu ứng 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 chuyến xe). Vui lòng xem TransitionAttributes.delay.

Duration

Tổng thời lượng của các khoảng thời gian xuất hiện 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 thời gian chèn đượ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, xin lưu ý rằng thời gian chờ này có thể được chia thành nhiều khoảng thời gian không liên tục.

Duration

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

• lần truy cập tiếp theo start_time (hoặc vehicle_end_time nếu đây là quá trình chuyển đổi cuối cùng) – start_time của quá trình chuyển đổi này;
• nếu ShipmentRoute.has_traffic_infeasibilities là false, thì điều kiện sau cũng được áp dụng: "total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Thời gian bắt đầu của hiệu ứng chuyển đổi này.

EncodedPolyline

Biểu thị bằng hình nhiều đường được mã hoá của tuyến đường đã đi trong quá trình chuyển đổi. Trường này chỉ được điền sẵn nếu bạn đặt populate_transition_polylines thành true.

string

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

map<string, VehicleLoad>

Tải trọng của xe trong quá trình chuyển đổi này, đối với 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ố chuyến hàng được thực hiện trên tuyến đường này.

Tải trong lần chuyển đổi đầu tiên là tải khởi động 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ừ để nhận được số lượt tải của 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 tải đã cho. Đơn vị tải thường được biểu thị bằng loại. Vui lòng xem Transition.vehicle_loads.

int32

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

bool

Nếu đúng, lượt truy cập sẽ tương ứng với lượt đến lấy Shipment. Nếu không, nó 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 vị trí bạn ghé thăm. Thời gian nhất quán với ShipmentModel.

map<string, Load>

Tổng nhu cầu tải trọng của lượt ghé thăm là tổng của yêu cầu vận chuyển và yêu cầu ghé thăm load_demands. Các giá trị này là âm nếu lượt truy cập là lượt phân phối. Nhu cầu được báo cáo cho cùng loại với Transition.loads (xem trường này).

Duration

Thời gian đi đường vòng thêm do các chuyến hàng được ghé thăm trên tuyến đường trước khi ghé thăm và do thời gian chờ tiềm ẩn do khung thời gian gây ra. Nếu lượt ghé thăm là lượt giao hàng, thì đường vòng sẽ được tính từ lượt ghé thăm tương ứng để lấy hà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 sẽ đượ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.

int32

Một mã thông báo mờ đại diện cho thông tin về vị trí mà người dùng đã ghé thăm.

Trường này có thể được điền sẵn trong các lượt truy cập vào tuyến đường kết quả khi VisitRequest.avoid_u_turns được đặt thành true cho lượt truy cập này hoặc nếu ShipmentModel.avoid_u_turns được đặt thành true trong yêu cầu OptimizeToursRequest.

Thử nghiệm: Xem https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request để biết thêm thông tin chi tiết.

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ố những lô hàng được liệt kê là "không tương thích".

IncompatibilityMode

Chế độ được áp dụng cho sự không tương thích.

string

Danh sách các loại hình 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 có các chuỗi yêu cầu mà shipment_type phụ thuộc vào chính nó.

RequirementMode

Chế độ được á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 nguồn ShipmentModel.

string

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

Reason

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

double

Đây là bản sao của Shipment.penalty_cost, được đưa vào đây để bạn dễ dàng xem mức độ nghiêm trọng của một lô hàng bị bỏ qua.

Thử nghiệm: Hành vi hoặc sự tồn tại của trường này có thể thay đổi trong tương lai.

double

Tỷ lệ ước tính của những xe không thể thực hiện chuyến vận chuyển này vì ít nhất một trong những lý do dưới đây. Lưu ý: trường này chỉ được điền khi lý do liên quan đến xe.

Thử nghiệm: Hành vi hoặc sự tồn tại của trường này có thể thay đổi trong tương lai.

Code

Tham khảo phần bình luận của Mã.

int32

Tương tự như example_vehicle_index, ngoại trừ việc chúng tôi cung cấp danh sách nhiều xe được xác định. Danh sách này chưa chắc đã đầy đủ. Trường này chỉ được điền nếu [fill_example_vehicle_indices_in_skipped_reasons][] là true.

Thử nghiệm: Hành vi hoặc sự tồn tại của trường này có thể thay đổi trong tương lai.

string

Nếu mã lý do là DEMAND_EXCEEDS_VEHICLE_CAPACITY, thì tài liệu này vượt quá một loại dung lượng.

int32

Nếu lý do liên quan đến việc xe vận chuyển không tương thích, 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 khung thời gian cố định. Nếu bạn không 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 cố định. Nếu bạn không 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 khung thời gian.

Timestamp

Thời gian kết thúc tương đối 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

Các 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 vào 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 trường nào trong hai trường này không trống).

string

Vui lòng xem src_tag. Phải có đúng một trong src_tag và excluded_src_tag.

string

Một lượt ghé thăm điểm đến hoặc điểm cuối 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 trường nào trong hai trường này không trống).

string

Vui lòng xem dst_tag. Phải có đúng một trong dst_tag và excluded_dst_tag.

double

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

double

Xác định chi phí trên mỗi ki-lô-mét áp dụng cho quãng đường đã đi trong khi thực hiện quá trình chuyển đổi này. Khoản phí này được cộng thêm vào bất kỳ Vehicle.cost_per_kilometer nào được chỉ định trên xe.

DistanceLimit

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

Kể từ ngày 6/2021, chỉ giới hạn mềm được hỗ trợ.

Duration

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

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

string

URI của tài nguyên. Tài nguyên có thể chưa tồn tại.

Nội dung của tài nguyên được mã hoá dưới dạng JSON hoặc textproto. Hệ thống chỉ hỗ trợ các tài nguyên trên Google Cloud Storage. Nếu tài nguyên được mã hoá dưới dạng JSON, thì tên tài nguyên phải có hậu tố là .json. Nếu tài nguyên được mã hoá dưới dạng textproto, thì tên tài nguyên phải có hậu tố là .txtpb. Ví dụ: URI Google Cloud Storage đến một tệp được mã hoá JSON có thể có dạng như sau: gs://bucket/path/input/object.json.

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 các 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 toán tuyến đường cho một chiếc xe nhất định.

LatLng

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

Waypoint

Điểm tham chiếu đại diện cho một 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 từ điểm đón đầu tiên. Nếu mô hình vận chuyển có ma trận khoảng cách và thời gian, thì bạn không được chỉ định start_waypoint.

LatLng

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

Waypoint

Điểm tham chiếu đại diện cho một vị trí địa lý nơi xe dừng lại 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 khi xe hoàn thành VisitRequest cuối cùng. Nếu mô hình vận chuyển có ma trận khoảng cách và thời gian, thì bạn không được chỉ định end_waypoint.

string

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

Không được phép có chuỗi trống hoặc chuỗi 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 có chuỗi trống hoặc chuỗi 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 toàn cầu (xem các trường ShipmentModel.global_*). Nếu không được chỉ định, sẽ không có giới hạn nào ngoài những giới hạn thời gian chung đó.

Các khung thời gian thuộc cùng một trường lặp lại phải rời rạc, tức là không có khung thời gian nào được trùng lặp hoặc nằm cạnh một khung thời gian khác và các khung thời gian 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 chỉ có một khung thời gian.

TimeWindow

Khung 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 toàn cầu (xem các trường ShipmentModel.global_*). Nếu không được chỉ định, sẽ không có giới hạn nào ngoài những giới hạn thời gian chung đó.

Các khung thời gian thuộc cùng một trường lặp lại phải rời rạc, tức là không có khung thời gian nào được trùng lặp hoặc nằm cạnh một khung thời gian khác và các khung thời gian 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 chỉ có một khung thời gian.

UnloadingPolicy

Chính sách 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 đường cho phương tiện. 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ể dẫn đến độ trễ bổ sung.

double

Chi phí cho mỗi giờ di chuyển của tuyến đường dành cho xe. Chi phí này chỉ áp dụng cho thời gian di chuyển của 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í trên mỗi ki-lô-mét của tuyến đường dành cho 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 ngầm định đi từ arrival_location đến departure_location của một VisitRequest duy nhất.

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 những xe không vận chuyển hàng hoá trên tuyến đường của mình. Thuộc tính này cho biết liệu xe có được coi là xe đã 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 chi phí thời gian và khoảng cách phát sinh từ hành trình bắt đầu --> kết thúc sẽ được tính đến.

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 thời gian 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 thông tin nào ngoại trừ chỉ mục và nhãn của xe.

DurationLimit

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

DurationLimit

Giới hạn được áp dụng cho thời gian di chuyển của tuyến đường mà xe đi. 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 mà xe đi. Trong một OptimizeToursResponse nhất định, khoảng cách 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 khoảng thời gian. Thời lượng là thời gian ngoài VisitRequest.duration được tính cho các lượt ghé thăm có visit_types được chỉ định. Thời gian ghé thăm bổ sung này sẽ làm tăng chi phí nếu bạn chỉ định cost_per_hour. Không được để trống các khoá (tức là visit_types).

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

BreakRule

Mô tả lịch nghỉ giải lao bắt buộc đối với xe này. Nếu bạn không nhập thông tin, thì sẽ không có thời gian nghỉ nào được lên lịch cho xe này.

string

Chỉ định một 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 là true, thì used_if_route_is_empty phải là false và chiếc 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 phương tiện 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 phương tiện bị bỏ qua trong injected_solution_constraint và mọi hoạt động nhận/giao hàng liên quan đều bị hạn chế ở trên phương tiện (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ụ: nếu bạn đặt giá trị này thành 2.0, tức là chiếc xe này chạy chậm hơn và 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 của lượt truy cập. Điều 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,0]. Nếu bạn không đặt, 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 hệ số này được áp dụng nhưng trước khi thực hiện bất kỳ thao tác số học nào. Do đó, hệ số nhỏ có thể dẫn đến việc mất độ chính xác.

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

Duration

Một 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 áp dụng giới hạn thời lượng tối đa, nhưng khi bị vi phạm, tuyến đường sẽ phát sinh chi phí. Chi phí này cộng với các chi phí khác được xác định trong mô hình, có cùng đơ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 áp dụng 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 chi phí, bình phương theo 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, có cùng đơn vị.

Nếu được xác định, quadratic_soft_max_duration phải là số không âm. Nếu bạn cũng xác định max_duration, thì quadratic_soft_max_duration phải nhỏ hơn max_duration và sự khác biệt 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 bạn vi phạm ngưỡng soft_max_duration. Chi phí phát sinh thêm 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í không được là số âm.

double

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

Chi phí phát sinh thêm 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í không được là số â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 trọng vượt quá soft_max_load trên 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 trọng – 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. Bạn chỉ có thể xác định giới hạn mềm cho các loại chỉ áp dụng cho việc đến lấy hoặc chỉ áp dụng cho việc giao hàng trong toàn bộ mô hình.

Interval

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

Interval

Khoảng thời gian chấp nhận được để tải hàng lên xe ở cuối tuyến đường.

int64

Lượng tải tối đa có thể chấp nhận được.

LoadCost

Chi phí di chuyển một đơn vị tải trọng trên quãng đường một ki-lô-mét cho xe này. Bạn có thể dùng thông tin này làm thông tin thay thế cho mức tiêu thụ nhiên liệu: nếu tải là trọng lượng (tính bằng Newton), thì tải*km sẽ có kích thước của năng lượng.

Thử nghiệm: Xem https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request để biết thêm thông tin chi tiết.

LoadCost

Chi phí di chuyển với một đơn vị tải trong một giờ cho xe này.

Thử nghiệm: Xem https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request để biết thêm thông tin chi tiết.

int64

Mức tải tối thiểu có thể chấp nhận được. Phải lớn hơn hoặc bằng 0. Nếu cả hai đều được chỉ định, thì min phải ≤ max.

int64

Mức tải tối đa chấp nhận được. Phải lớn hơn hoặc bằng 0. Nếu không được chỉ định, thông báo này sẽ không giới hạn tải trọng tối đa. Nếu cả hai đều được chỉ định, thì min phải ≤ max.

int64

Lượng tải mà khi vượt quá, chi phí di chuyển một đơn vị tải sẽ thay đổi từ cost_per_unit_below_threshold thành cost_per_unit_above_threshold. Phải lớn hơn hoặc bằng 0.

double

Chi phí di chuyển một đơn vị tải, cho mỗi đơn vị từ 0 đến ngưỡng. Phải là một giá trị hữu hạn và lớn hơn hoặc bằng 0.

double

Chi phí di chuyển một đơn vị tải, cho mỗi đơn vị vượt quá ngưỡng. Trong trường hợp đặc biệt, ngưỡng = 0, đây là chi phí cố định cho mỗi đơn vị. Phải là một giá trị hữu hạn và lớn hơn hoặc bằng 0.

double

Tối đa cho tất cả các trường khác trong thư này.

double

Tỷ lệ giữa AggregatedMetrics.travel_distance_meters và Vehicle.route_distance_limit. Nếu bạn không đặt Vehicle.route_distance_limit, thì trường này sẽ không được đặt.

double

Tỷ lệ giữa [AggregatedMetrics.travel_duration_seconds][] và Vehicle.travel_duration_limit. Nếu bạn không đặt Vehicle.travel_duration_limit, thì trường này sẽ không được đặt.

double

Tỷ lệ giữa [AggregatedMetrics.total_duration_seconds][] và Vehicle.route_duration_limit. Nếu bạn không đặt Vehicle.route_duration_limit, thì trường này sẽ không được đặt.

double

Tỷ lệ tối đa trong số tất cả các loại [AggregatedMetrics.max_load][] và Vehicle.load_limits tương ứng của chúng. Nếu bạn huỷ thiết lập tất cả các trường Vehicle.load_limits, thì trường này cũng sẽ bị huỷ thiết lập.

double

Tỷ lệ (vehicle_end_time – vehicle_start_time) / (latest_vehicle_end_time – earliest_vehicle_start_time) cho một chiếc xe cụ thể. Nếu không có mẫu số, hệ thống sẽ dùng (ShipmentModel.global_end_time – ShipmentModel.global_start_time) để thay thế.

bool

Không bắt buộc. Cho biết rằng vị trí của điểm tham chiếu này có nghĩa là xe nên 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í đó hướng đến từ giữa đường. Lựa chọn này không hoạt động đối với chế độ di chuyển "ĐI BỘ".

bool

Cho biết rằng điểm tham chiếu dành cho xe dừng lại, nơi có ý định đón hoặc trả khách. Lựa chọn này chỉ hoạt động cho chế độ di chuyển "DRIVING" và khi "location_type" là "location".

Thử nghiệm: Hành vi hoặc sự tồn tại của trường này có thể thay đổi trong tương lai.

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 của địa điểm yêu thích được liên kết với điểm tham chiếu.

Khi sử dụng mã địa điểm để chỉ định vị trí đến hoặc đi của VisitRequest, hãy sử dụng mã địa điểm đủ cụ thể để xác định vị trí LatLng cho chỉ đường đến địa điểm đó. Ví dụ: mã địa điểm đại diện cho một toà nhà là phù hợp, nhưng mã địa điểm đại diện cho một con đường thì không nên dùng.