Sử dụng phương thức ListVehicles
để tìm tất cả xe đáp ứng một số tuỳ chọn yêu cầu cụ thể. Phương thức ListVehicles
trả về danh sách xe được phân trang trong dự án khớp với các truy vấn trên các trường xe.
Lọc theo thuộc tính xe
Bạn cũng có thể sử dụng phương thức này để lọc theo các thuộc tính của xe. Các thuộc tính này đóng vai trò là toán tử AND khi được sử dụng kết hợp với các thông số kỹ thuật khác của trường. Để biết thông tin chi tiết về cú pháp truy vấn bộ lọc, hãy xem phần Lọc: AIP-160 để biết ví dụ. Để biết thông tin chi tiết về cách tạo thuộc tính xe, hãy xem Trường thuộc tính xe trong hướng dẫn Cập nhật các trường xe.
Ví dụ về danh sách xe
Ví dụ này lọc trên cả trường vehicle_type
và attributes
bằng cách sử dụng chuỗi filter
, chỉ hiển thị các loại xe thuộc loại AUTO và lấy giá trị LUXURY cho thuộc tính tuỳ chỉnh của class
.
Java
static final String PROJECT_ID = "project-id";
VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
ListVehiclesRequest listVehiclesRequest = ListVehiclesRequest.newBuilder()
.setParent(parent)
.addTripTypes(TripType.EXCLUSIVE)
.addVehicleTypes(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
.setFilter("attributes.on_trip=\"false\"")
.setIncludeBackToBack(true) // Fleet Engine includes vehicles that are en route.
.build();
// Error handling
// If matches are returned and the authentication passed, the request completed
// successfully
try {
ListVehiclesResponse listVehiclesResponse =
vehicleService.listVehicles(listVehiclesRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
curl -X POST \
"https://fleetengine.googleapis.com/v1/providers/project-id/vehicles:list" \
-H "Authorization: Bearer $JWT" \
-H "Content-Type: application/json" \
--data-binary @- << EOM
{
"vehicleTypes": [{"category": "AUTO"}],
"filter": "attributes.class=\"LUXURY\"",
}
EOM