Trang này được dịch bởi Cloud Translation API.

REST Resource: providers.deliveryVehicles

Tài nguyên: DeliveryVehicle
- Biểu diễn dưới dạng JSON
DeliveryVehicleNavigationStatus
DeliveryVehicleAttribute
- Biểu diễn dưới dạng JSON
DeliveryVehicleType
Phương thức

Tài nguyên: DeliveryVehicle

Thông báo DeliveryVehicle. Xe tải giao hàng vận chuyển các lô hàng từ kho đến địa điểm giao hàng và từ địa điểm lấy hàng đến kho. Trong một số trường hợp, xe giao hàng cũng vận chuyển hàng hoá trực tiếp từ địa điểm lấy hàng đến địa điểm giao hàng.

Lưu ý: API gRPC và REST sử dụng các quy ước đặt tên trường khác nhau. Ví dụ: trường DeliveryVehicle.current_route_segment trong API gRPC và trường DeliveryVehicle.currentRouteSegment trong API REST tham chiếu đến cùng một trường.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng JSON
{ "name": string, "lastLocation": { object (`DeliveryVehicleLocation`) }, "pastLocations": [ { object (`DeliveryVehicleLocation`) } ], "navigationStatus": enum (`DeliveryVehicleNavigationStatus`), "currentRouteSegment": string, "currentRouteSegmentEndPoint": { object (`LatLng`) }, "remainingDistanceMeters": integer, "remainingDuration": string, "remainingVehicleJourneySegments": [ { object (`VehicleJourneySegment`) } ], "attributes": [ { object (`DeliveryVehicleAttribute`) } ], "type": enum (`DeliveryVehicleType`) }

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

Trường
`name`	`string` Tên duy nhất của Xe phân phối này. Định dạng là `providers/{provider}/deliveryVehicles/{vehicle}`.
`lastLocation`	`object (DeliveryVehicleLocation)` Vị trí gần đây nhất được báo cáo của Xe giao hàng.
`pastLocations[]`	`object (DeliveryVehicleLocation)` Chỉ nhập. Những địa điểm mà Xe giao hàng này đã từng đến nhưng chưa được báo cáo cho Công cụ quản lý đội xe. Phương thức này được dùng trong `UpdateDeliveryVehicleRequest` để ghi lại những vị trí trước đây không thể gửi đến máy chủ. Điều này thường xảy ra khi Xe phân phối không có kết nối Internet.
`navigationStatus`	`enum (DeliveryVehicleNavigationStatus)` Trạng thái chỉ đường của Xe giao hàng.
`currentRouteSegment`	`string (bytes format)` Hình đa tuyến được mã hoá chỉ định tuyến đường mà tính năng chỉ đường đề xuất đi đến điểm trung gian 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ừ VehicleStop đã đi qua gần đây nhất đến VehicleStop 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ề đường dẫn hiện tại của Xe giao hàng. Chuỗi được mã hoá base64.
`currentRouteSegmentEndPoint`	`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`. Đây là `LatLng` từ điểm dừng xe sắp tới hoặc `LatLng` cuối cùng của `currentRouteSegment`. Sau đó, Công cụ của Fleet sẽ cố gắng hết sức để nội suy thành `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.
`remainingDistanceMeters`	`integer` Khoảng cách 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_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.
`remainingDuration`	`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 tác vụ đ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. 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"`.
`remainingVehicleJourneySegments[]`	`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`.
`attributes[]`	`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 biệt.
`type`	`enum (DeliveryVehicleType)` Loại xe giao hàng này. Nếu bạn không đặt, giá trị mặc định sẽ là `AUTO`.

DeliveryVehicleNavigationStatus

Trạng thái điều hướng của xe.

Enum
`UNKNOWN_NAVIGATION_STATUS`	Trạng thái điều hướng không xác định.
`NO_GUIDANCE`	Thành phần điều hướng của ứng dụng Driver (Trình điều khiển) ở chế độ `FREE_NAV`.
`ENROUTE_TO_DESTINATION`	Bạn có thể sử dụng tính năng chỉ đường từng chặng và tính năng chỉ đường trong ứng dụng Trình điều khiển đã chuyển sang chế độ `GUIDED_NAV`.
`OFF_ROUTE`	Xe đã đi ra khỏi tuyến đường được đề xuất.
`ARRIVED_AT_DESTINATION`	Xe cách điểm đến khoảng 50 m.

DeliveryVehicleAttribute

Mô tả một thuộc tính của xe dưới dạng một cặp khoá-giá trị. Chiều dài chuỗi "khoá:giá trị" không được vượt quá 256 ký tự.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng JSON
{ "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`. }

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

Trường
`key`	`string` Khoá của thuộc tính.
`value`	`string` Giá trị của thuộc tính.
Trường hợp hợp nhất `delivery_vehicle_attribute_value`. Giá trị của thuộc tính có thể ở dạng chuỗi, bool hoặc double. `delivery_vehicle_attribute_value` chỉ có thể là một trong những loại sau:
`stringValue`	`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 các 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 này, 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.
`boolValue`	`boolean` Giá trị thuộc tính được nhập bằng boolean.
`numberValue`	`number` Giá trị thuộc tính được nhập hai lần.

DeliveryVehicleType

Loại xe giao hàng.

Enum
`DELIVERY_VEHICLE_TYPE_UNSPECIFIED`	Giá trị này không được sử dụng.
`AUTO`	Một chiếc ô tô.
`TWO_WHEELER`	Xe mô tô, xe máy hoặc phương tiện hai bánh khác
`BICYCLE`	Phương tiện vận tải do con người vận hành.
`PEDESTRIAN`	Phương tiện vận chuyển con người, thường là đi bộ hoặc chạy dọc theo đường đi bộ.

Phương thức
`create`	Tạo và trả về một `DeliveryVehicle` mới.
`delete`	Xoá DeliveryVehicle khỏi Công cụ quản lý đội xe.
`get`	Trả về thực thể `DeliveryVehicle` đã chỉ định.
`list`	Lấy tất cả `DeliveryVehicle` đáp ứng tiêu chí lọc đã chỉ định.
`patch`	Ghi dữ liệu `DeliveryVehicle` đã cập nhật vào Công cụ của đội xe và chỉ định `Tasks` cho `DeliveryVehicle`.

REST Resource: providers.deliveryVehicles

Tài nguyên: DeliveryVehicle

DeliveryVehicleNavigationStatus

DeliveryVehicleAttribute

DeliveryVehicleType

Phương thức

`create`

`delete`

`get`

`list`

`patch`