VehicleJourneySegment

Đại diện cho đoạn đường đi của xe – từ điểm dừng trước đến điểm dừng hiện tại. Nếu đây là điểm dừng đầu tiên, thì điểm dừng đó sẽ tính từ vị trí hiện tại của xe đến điểm dừng này.

Biểu diễn dưới dạng JSON 
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
Các trường
stop

object (VehicleStop)

Chỉ định vị trí dừng, cùng với các Task liên kết với điểm dừng đó. Một số trường của CarsStop có thể không xuất hiện nếu phân đoạn hành trình này là một phần của JourneySharingInfo.
drivingDistanceMeters

integer

Chỉ có đầu ra. Quãng đường đi được từ điểm dừng trước đó đến điểm dừng này. Nếu điểm dừng hiện tại là điểm dừng đầu tiên trong danh sách các chặng của hành trình, thì điểm xuất phát là vị trí của xe được ghi lại tại thời điểm điểm dừng này được thêm vào danh sách. Trường này có thể không xuất hiện nếu giai đoạn hành trình này là một phần của JourneySharingInfo.
drivingDuration

string (Duration format)

Chỉ có đầu ra. Thời gian di chuyển từ điểm dừng trước đến điểm dừng này. Nếu điểm dừng hiện tại là điểm dừng đầu tiên trong danh sách phân đoạn của hành trình, thì điểm xuất phát là vị trí của xe được ghi lại tại thời điểm điểm dừng này được thêm vào danh sách.

Nếu trường này được xác định trong đường dẫn Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) hoặc Task.remainingVehicleJourneySegments[0].drivingDuration (REST), thì trường này có thể được điền sẵn giá trị từ DeliveryVehicle.remaining_duration (gRPC) hoặc DeliveryVehicle.remainingDuration (REST). Giá trị này cung cấp thời gian lái xe còn lại từ vị trí đã biết gần đây nhất của ứng dụng lái xe, thay vì thời gian lái xe từ điểm dừng trước đó.

Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng 's'. Ví dụ: "3.5s".
path[]

object (LatLng)

Chỉ có đầu ra. Đường dẫn từ điểm dừng trước đến điểm dừng này. Nếu điểm dừng hiện tại là điểm dừng đầu tiên trong danh sách các chặng của hành trình, thì đây là lộ trình từ vị trí hiện tại của xe đến điểm dừng này tại thời điểm điểm dừng đó được thêm vào danh sách. Trường này có thể không xuất hiện nếu giai đoạn hành trình này là một phần của JourneySharingInfo.

Nếu trường này được xác định trong đường dẫn Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) hoặc Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), thì trường này có thể được điền sẵn bằng LatLng được giải mã từ DeliveryVehicle.current_route_segment (gRPC) hoặc DeliveryVehicle.currentRouteSegment (REST). Mục này cung cấp đường lái xe từ vị trí đã biết mới nhất của ứng dụng người lái thay vì đường dẫn từ điểm dừng trước đó.

VehicleStop

Mô tả một điểm mà Xe dừng lại để thực hiện một hoặc nhiều Task.

Biểu diễn dưới dạng JSON 
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
Các trường
plannedLocation

object (LocationInfo)

Bắt buộc. Vị trí dừng. Lưu ý rằng các vị trí trong Task có thể không khớp chính xác với vị trí này nhưng sẽ cách đó một khoảng ngắn. Trường này sẽ không được điền sẵn khi phản hồi lệnh gọi tasks.get hoặc tasks.search.
tasks[]

object (TaskInfo)

Danh sách các Task sẽ được thực hiện tại điểm dừng này. Trường này sẽ không được điền sẵn khi có lệnh gọi tasks.get hoặc tasks.search.
state

enum (State)

Trạng thái của VehicleStop. Trường này sẽ không được điền sẵn khi phản hồi lệnh gọi tasks.get hoặc tasks.search.

TaskInfo

Thông tin bổ sung về Nhiệm vụ được thực hiện tại điểm dừng này.

Biểu diễn dưới dạng JSON 
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
Các trường
taskId

string

Mã việc cần làm. Trường này sẽ không được điền sẵn khi phản hồi lệnh gọi tasks.get hoặc tasks.search. Mã việc cần làm phải tuân theo các hạn chế sau:

  • Phải là một chuỗi Unicode hợp lệ.
  • Có độ dài tối đa là 64 ký tự.
  • Được chuẩn hoá theo Biểu mẫu chuẩn hoá Unicode.
  • Không được chứa bất kỳ ký tự ASCII nào sau đây: "/", ":", "?", ",", hoặc "#".
taskDuration

string (Duration format)

Chỉ có đầu ra. Thời gian cần thiết để thực hiện Tác vụ.

Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng 's'. Ví dụ: "3.5s".
targetTimeWindow

object (TimeWindow)

Chỉ có đầu ra. Khoảng thời gian để hoàn thành tác vụ. Giá trị này chỉ được đặt để phản hồi deliveryVehicles.get.

Tiểu bang

Trạng thái hiện tại của VehicleStop.

Enum
STATE_UNSPECIFIED Không xác định.
NEW Đã tạo nhưng không chủ động định tuyến.
ENROUTE Đã chỉ định và chủ động định tuyến.
ARRIVED Đã đến điểm dừng. Giả sử khi xe đang chuyển đến điểm dừng tiếp theo, tất cả các điểm dừng trước đó đều đã hoàn thành.