VehicleJourneySegment

Đại diện cho đoạn đường di chuyển của một chiếc 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 hoạt động đầu tiên, thì tức là 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)
    }
  ]
}
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 VehicleStop có thể không xuất hiện nếu đoạn đường này là một phần của JourneySharingInfo.

drivingDistanceMeters

integer

Chỉ có đầu ra. Quãng đường đã đi 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 đoạn đường, 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 phân đoạn trong 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 đi 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 đoạn đường, 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 bạn xác định trường này trong đường dẫn Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) hoặc Task.remainingVehicleJourneySegments[0].drivingDuration (REST), thì trường đó có thể được điền bằng giá trị từ DeliveryVehicle.remaining_duration (gRPC) hoặc DeliveryVehicle.remainingDuration (REST). Thông tin này cung cấp thời gian lái xe còn lại từ vị trí đã biết mới 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 với 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. Con đường 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 đoạn đường, thì đây là đường đi 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 phân đoạn trong hành trình này là một phần của JourneySharingInfo.

Nếu bạn xác định trường này 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 đó có thể được điền bằng các LatLng được giải mã từ DeliveryVehicle.current_route_segment (gRPC) hoặc DeliveryVehicle.currentRouteSegment (REST). Thuộc tính này cung cấp đường lái xe từ vị trí đã biết mới nhất của ứng dụng lái xe thay vì đường dẫn từ điểm dừng trước đó.

VehicleStop

Mô tả một điểm mà Xe dừng để 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)
}
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ẽ nằm trong khoảng cách ngắn so với vị trí đó. Trường này sẽ không được điền sẵn trong nội dung phản hồi của lệnh gọi tasks.get.

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 trong nội dung phản hồi của lệnh gọi tasks.get.

state

enum (State)

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

TaskInfo

Thông tin bổ sung về Tác 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)
  }
}
Trường
taskId

string

Mã việc cần làm. Trường này sẽ không được điền sẵn trong nội dung phản hồi của lệnh gọi tasks.get. Mã việc cần làm phải tuân theo các quy định hạn chế sau:

  • Phải là một chuỗi Unicode hợp lệ.
  • Giới hạn độ dài tối đa là 64 ký tự.
  • Được chuẩn hóa theo Biểu mẫu chuẩn hóa Unicode C.
  • 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 Việc cần làm.

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

targetTimeWindow

object (TimeWindow)

Chỉ có đầu ra. Khoảng thời gian hoàn thành tác vụ. Thuộc tính này chỉ được đặt trong phản hồi cho 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à đang chủ động định tuyến.
ARRIVED Đã đến điểm dừng. Giả sử rằng khi Xe đang đi đến điểm dừng tiếp theo, thì tất cả điểm dừng trước đó đã hoàn tất.