VehicleJourneySegment

Đại diện cho đoạn đường di chuyển của xe, từ điểm dừng trước đó đến điểm dừng hiện tại. Nếu đó là điểm dừng đầu tiên hoạt động, thì tức là 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)
    }
  ]
}
Trường
stop

object (VehicleStop)

Chỉ định vị trí dừng, cùng với Task được liên kết với điểm dừng đó. Một số trường của DeviceStop 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ừ đ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 đoạn đường đi, 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ừ đ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 đoạn đường đi, thì điểm bắt đầu 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 bằng giá trị từ DeliveryVehicle.remaining_duration (gRPC) hoặc DeliveryVehicle.remainingDuration (REST). Thời gian này cho biết thời gian lái xe còn lại tính từ vị trí 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ố thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
path[]

object (LatLng)

Chỉ có đầu ra. Đườ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 đoạn đường đi, 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 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). Thuộc tính này cung cấp đường dẫn lái xe từ vị trí đã biết mới nhất của ứng dụng dành cho người 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í của điểm 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ẽ ở trong một khoảng cách ngắn từ nó. Trường này sẽ không được điền sẵn khi phản hồi 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 khi phản hồi 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 khi phản hồi lệnh gọi tasks.get.

TaskInfo

Thông tin bổ sung về Việc cần làm đượ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 khi phản hồi lệnh gọi tasks.get. 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ệ.
  • Giới hạn độ dài tối đa là 64 ký tự.
  • Được chuẩn hoá theo 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 Nhiệm vụ.

Thời lượng tính bằng giây với 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 hoàn thành việc cần làm. Thuộc tính 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 nơi. Giả sử khi Xe đang đi đến điểm dừng tiếp theo, thì tất cả các điểm dừng trước đó đã hoàn tất.