VehicleJourneySegment

Biểu thị một đoạn hành trình 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 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 đường này là một phần của JourneySharingInfo.
drivingDistanceMeters

integer

Chỉ có đầu ra. Khoảng cách 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 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 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 đườ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 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 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, 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. 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 đoạn 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). 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 để 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 một khoảng cách ngắn. 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 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ã công việc. 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 hoá theo Unicode Normalization Form C (Biểu mẫu 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 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.