REST Resource: providers.deliveryVehicles

{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}

string

Tên duy nhất của Xe phân phối này. Định dạng là providers/{provider}/deliveryVehicles/{vehicle}.

object (DeliveryVehicleLocation)

Vị trí được báo cáo gần đây nhất của Xe giao hàng.

enum (DeliveryVehicleNavigationStatus)

Trạng thái đi theo chỉ dẫn của Xe giao hàng.

string (bytes format)

Hình nhiều đường được mã hoá chỉ định tuyến đường mà tính năng điều hướng đề xuất đi đến điểm tham chiếu tiếp theo. Ứng dụng trình điều khiển sẽ cập nhật thông tin này khi bạn đến hoặc đi qua một điểm dừng và khi chỉ đường định tuyến lại. Các LatLng này được trả về trong Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) hoặc Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) cho tất cả các Tác vụ đang hoạt động được chỉ định cho Xe.

Có một số trường hợp trường này có thể không được dùng để điền sẵn Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) hoặc Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

• Điểm cuối của currentRouteSegment không khớp với DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) hoặc DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

• Ứng dụng trình điều khiển chưa cập nhật vị trí gần đây, vì vậy, giá trị cập nhật gần đây nhất cho trường này có thể đã lỗi thời.

• Ứng dụng trình điều khiển gần đây đã cập nhật vị trí của ứng dụng, nhưng currentRouteSegment đã lỗi thời và trỏ đến một điểm dừng xe trước đó.

Trong những trường hợp này, Công cụ quản lý đội xe sẽ điền sẵn vào trường này một tuyến đường từ Điểm dừng xe gần đây nhất đã đi qua đến Điểm dừng xe sắp tới để đảm bảo rằng người dùng của trường này có thông tin tốt nhất hiện có về lộ trình hiện tại của Xe tải giao hàng.

Chuỗi được mã hoá base64.

object (LatLng)

Vị trí kết thúc currentRouteSegment. Ứng dụng trình điều khiển hiện không điền giá trị này, nhưng bạn có thể cung cấp giá trị này trên các lệnh gọi deliveryVehicles.patch. Đó là LatLng từ trạm xe sắp tới hoặc LatLng cuối cùng của currentRouteSegment. Sau đó, Fleet Engine sẽ cố gắng hết sức để nội suy vào một VehicleStop thực tế.

Trường này sẽ bị bỏ qua trong các lệnh gọi deliveryVehicles.patch nếu trường currentRouteSegment trống.

integer

Quãng đường còn lại để lái xe cho currentRouteSegment. Ứng dụng Trình điều khiển thường cung cấp trường này, nhưng có một số trường hợp mà Công cụ xe sẽ ghi đè giá trị do ứng dụng gửi. Để biết thêm thông tin, hãy xem DeliveryVehicle.current_route_segment. Trường này được trả về trong Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) hoặc Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) cho tất cả Task đang hoạt động được chỉ định cho Xe phân phối.

Công cụ của Fleet sẽ bỏ qua trường này trong UpdateDeliveryVehicleRequest nếu trường currentRouteSegment trống.

string (Duration format)

Thời gian lái xe còn lại cho currentRouteSegment. Ứng dụng Trình điều khiển thường cung cấp trường này, nhưng có một số trường hợp mà Công cụ của đội xe sẽ ghi đè giá trị do ứng dụng gửi. Để biết thêm thông tin, hãy xem DeliveryVehicle.current_route_segment. Trường này được trả về trong Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) hoặc Task.remainingVehicleJourneySegments[0].drivingDuration (REST) cho tất cả các nhiệm vụ đang hoạt động được giao cho Xe giao hàng.

Fleet Engine bỏ qua trường này trong UpdateDeliveryVehicleRequest nếu trường currentRouteSegment trống.

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".

object (VehicleJourneySegment)

Các đoạn hành trình được chỉ định cho Xe giao hàng này, bắt đầu từ vị trí được báo cáo gần đây nhất của Xe. Trường này sẽ không được điền trong phản hồi của deliveryVehicles.list.

object (DeliveryVehicleAttribute)

Danh sách các thuộc tính tuỳ chỉnh của Xe giao hàng. Một Xe phân phối có thể có tối đa 100 thuộc tính và mỗi thuộc tính phải có một khoá riêng.

enum (DeliveryVehicleType)

Loại xe giao hàng này. Nếu không được đặt, giá trị này sẽ mặc định là AUTO.

{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}

string

Khoá của thuộc tính.

string

Giá trị của thuộc tính.

string

Giá trị thuộc tính được nhập dưới dạng chuỗi.

Lưu ý: Trường này giống với trường value mà cuối cùng sẽ không được dùng nữa. Đối với phương thức tạo hoặc cập nhật, bạn có thể sử dụng một trong hai trường, nhưng bạn nên sử dụng stringValue. Nếu bạn đặt cả stringValue và value, thì các giá trị này phải giống nhau, nếu không sẽ xảy ra lỗi. Cả hai trường đều được điền sẵn trong phản hồi.

boolean

Giá trị thuộc tính được nhập bằng Boolean.

number

Nhập giá trị thuộc tính hai lần.