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í điểm dừng, cùng với các Task được 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 hành trình này là một phần của JourneySharingInfo.
drivingDistanceMeters

integer

Chỉ có đầu ra. Khoảng cách di chuyển từ trạm trước đến trạm 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 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 đ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ừ trạm trước đến trạm 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 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). Thông tin này cung cấp thời lượng lái xe còn lại từ vị trí đã biết mới nhất của ứng dụng hỗ trợ 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ố thập phân, 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 đoạn hành trình, 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 đ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 bằng LatLng được giải mã từ DeliveryVehicle.current_route_segment (gRPC) hoặc DeliveryVehicle.currentRouteSegment (REST). Thông tin này cung cấp lộ trình lái xe từ vị trí đã biết gần đây nhất của ứng dụng dành cho người lái xe thay vì lộ trình 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)
}
Trường
plannedLocation

object (LocationInfo)

Bắt buộc. Vị trí của điểm dừng. Xin 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 phạm vi gần. Trường này sẽ không được điền trong phản hồi của lệnh gọi tasks.get.
tasks[]

object (TaskInfo)

Danh sách 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 trong 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ề 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)
  }
}
Trường
taskId

string

Mã công việc. Trường này sẽ không được điền trong 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 hoá theo Dạng chuẩn hoá 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, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
targetTimeWindow

object (TimeWindow)

Chỉ có đầu ra. Khoảng thời gian cần hoàn thành tác vụ. Giá trị 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 định tuyến.
ARRIVED Đã đến điểm dừng. Giả định rằng khi Xe đang định tuyến đến điểm dừng tiếp theo, tất cả các điểm dừng trước đó đều đã hoàn tất.