REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

Chỉ có đầu ra. Tên riêng biệt của chiếc xe này. Định dạng là providers/{provider}/vehicles/{vehicle}.

enum (VehicleState)

Trạng thái của xe.

enum (TripType)

Các loại chuyến đi được xe này hỗ trợ.

string

Chỉ có đầu ra. Danh sách tripId cho các chuyến đi hiện được chỉ định cho xe này.

object (VehicleLocation)

Vị trí được báo cáo gần đây nhất của chiếc xe.

integer

Tổng số hành khách trên xe này. Trình điều khiển không được xem xét trong giá trị này. Giá trị này phải lớn hơn hoặc bằng 1.

object (VehicleAttribute)

Danh sách các thuộc tính của xe. Một chiếc xe có thể có tối đa 100 thuộc tính và mỗi thuộc tính phải có một khoá duy nhất.

object (VehicleType)

Bắt buộc. Loại xe này. Có thể dùng để lọc phương tiện trong vehicles.search kết quả. Ngoài ra còn ảnh hưởng đến việc tính toán tuyến đường và giờ đến dự kiến.

object (LicensePlate)

Thông tin về biển số xe của xe.

object (TerminalLocation)

Không dùng nữa: Chuyển sang dùng Vehicle.waypoints.

string

Hình nhiều đường chỉ định tuyến đường mà ứng dụng trình điều khiển định đi đến điểm tham chiếu tiếp theo. Danh sách này cũng được trả về trong Trip.current_route_segment cho tất cả chuyến đi đang hoạt động được chỉ định cho xe.

Lưu ý: Trường này chỉ dành cho SDK trình điều khiển sử dụng. Tính năng giải mã chưa được hỗ trợ.

object (TrafficPolylineData)

Chỉ nhập. Fleet Engine sử dụng thông tin này để cải thiện tính năng chia sẻ hành trình. Lưu ý: Trường này chỉ dành cho SDK trình điều khiển sử dụng.

string (Timestamp format)

Chỉ có đầu ra. Thời điểm đặt currentRouteSegment. Ứng dụng có thể lưu trữ mã này và truyền vào các yêu cầu vehicles.get trong tương lai để ngăn trả về các tuyến chưa thay đổi.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

Điểm tham chiếu kết thúc currentRouteSegment. Người lái xe có thể cung cấp giá trị này trong các lệnh gọi vehicles.update dưới dạng điểm tham chiếu đầy đủ, điểm tham chiếu LatLng 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 điểm tham chiếu thực tế nếu điểm đó không được chỉ định đầy đủ. Trường này sẽ bị bỏ qua trong các lệnh gọi vehicles.update trừ phi bạn cũng chỉ định currentRouteSegment.

integer

Quãng đường lái xe còn lại của currentRouteSegment. Giá trị này cũng được trả về bằng Trip.remaining_distance_meters cho tất cả chuyến đi đang hoạt động được chỉ định cho xe. Bạn không chỉ định giá trị này nếu trường currentRouteSegment trống.

string (Timestamp format)

Giờ đến dự kiến cho mục đầu tiên trong trường waypoints. Bạn không thể chỉ định giá trị nếu trường waypoints trống hoặc trường Vehicle.current_route_segment trống.

Khi cập nhật một chiếc xe, remainingTimeSeconds sẽ được ưu tiên hơn etaToFirstWaypoint trong cùng một yêu cầu.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

integer

Chỉ nhập. Thời gian lái xe còn lại cho currentRouteSegment. Bạn không thể chỉ định giá trị nếu trường waypoints trống hoặc trường Vehicle.current_route_segment trống. Giá trị này phải khớp với etaToFirstWaypoint – current_time nếu tất cả các bên sử dụng cùng một đồng hồ.

Khi cập nhật một chiếc xe, remainingTimeSeconds sẽ được ưu tiên hơn etaToFirstWaypoint trong cùng một yêu cầu.

object (TripWaypoint)

Các điểm tham chiếu còn lại được chỉ định cho Xe này.

string (Timestamp format)

Chỉ có đầu ra. Lần gần đây nhất, trường waypoints được cập nhật. Ứng dụng nên lưu giá trị này vào bộ nhớ đệm và truyền giá trị này vào GetVehicleRequest để đảm bảo trường waypoints chỉ được trả về nếu được cập nhật.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

boolean

Cho biết tài xế có chấp nhận các chuyến đi khứ hồi hay không. Nếu là true, vehicles.search có thể bao gồm chiếc xe này ngay cả khi chiếc xe này hiện được chỉ định cho một chuyến đi. Giá trị mặc định là false.

enum (NavigationStatus)

Trạng thái đi theo chỉ dẫn của xe.

object (DeviceSettings)

Chỉ nhập. Thông tin về các chế độ cài đặt trong thiết bị di động mà người lái xe sử dụng.

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

  // Union field 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 vehicle_attribute_value.
}

string

Khoá của thuộc tính. Khoá không được chứa ký tự dấu hai chấm (:).

string

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

string

Giá trị thuộc tính đã nhập chuỗi.

Lưu ý: Trường này giống với trường value mà sau này 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ì hai thuộc tính này phải giống hệt nhau, nếu không sẽ xảy ra lỗi. Cả hai trường đều được điền sẵn câu trả lời.

boolean

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

number

Giá trị thuộc tính được nhập hai lần.

{
  "category": enum (Category)
}

enum (Category)

Danh mục loại xe

{
  "countryCode": string,
  "lastCharacter": string
}

string

Bắt buộc. Mã quốc gia/khu vực CLDR. Ví dụ: US cho Hoa Kỳ hoặc IN cho Ấn Độ.

string

Chữ số cuối cùng của biển số xe hoặc "-1" để biểu thị không có giá trị số nào trên biển số xe.

• "ABC 1234" -> "4"
• "AB 123 CD" -> "3"
• "ABCDEF" -> "-1"

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object (VisualTrafficReportPolylineRendering)

Hình nhiều đường thể hiện tốc độ giao thông cho tất cả các khu vực trên một đoạn đường của khách hàng.

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object (RoadStretch)

Không bắt buộc. Đoạn đường sẽ được hiển thị dọc theo hình nhiều đường. Các đoạn kéo dài được đảm bảo không chồng chéo và không nhất thiết phải kéo dài toàn bộ tuyến đường.

Trong trường hợp không có đường kéo dài để tạo kiểu, ứng dụng khách nên áp dụng giá trị mặc định cho tuyến đường.

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum (Style)

Bắt buộc. Kiểu nên áp dụng.

integer

Bắt buộc. Kiểu phải được áp dụng trong khoảng thời gian [offsetMeters, offsetMeters + lengthMeters).

integer

Bắt buộc. Độ dài của đường dẫn nơi áp dụng kiểu.

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum (LocationPowerSaveMode)

Cách các tính năng vị trí hoạt động trên thiết bị khi trình tiết kiệm pin đang bật.

boolean

Liệu thiết bị hiện có đang ở chế độ tiết kiệm điện năng hay không.

boolean

Xem thiết bị có đang ở trạng thái tương tác hay không.

object (BatteryInfo)

Thông tin về trạng thái pin.

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum (BatteryStatus)

Trạng thái pin, pin đầy hay đang sạc, v.v.

enum (PowerSource)

Trạng thái của nguồn pin.

number

Phần trăm pin hiện tại [0-100].