استخدام الطريقة ListVehicles
للعثور على جميع المركبات التي تستوفي بعض معايير معيّنة
خيارات الطلب. تعرض الطريقة ListVehicles
قائمة مركبات مقسّمة على صفحات.
في المشروع بحيث تتطابق مع الاستعلامات عبر حقول المركبة.
الفلترة حسب سمات المركبات
يمكنك أيضًا استخدام هذه الطريقة للفلترة على سمات المركبات، والتي تعمل كـ "و" عند استخدامه مع مواصفات حقول أخرى. للحصول على التفاصيل على بنية طلب البحث للفلتر، راجِع الفلترة: AIP-160 للحصول على أمثلة. للحصول على تفاصيل حول إنشاء سمات المركبة، يُرجى الاطّلاع على القسم "المركبة". الخاصة بالسمات في دليل تعديل حقول المركبات.
مثال على المركبة
يؤدي هذا المثال إلى فلترة كلٍّ من الحقلَين vehicle_type
وattributes
باستخدام
سلسلة filter
، التي تعرض فقط المركبات من النوع auto والحصول على LUXURY
للسمة المخصصة 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