استخدِم طريقة ListVehicles
للعثور على جميع المركبات التي تستوفي بعض خيارات الطلب المحدّدة. تعرض الطريقة ListVehicles
قائمة مقسّمة إلى صفحات بالمركبات
في المشروع التي تتطابق مع طلبات البحث في حقول المركبات.
الفلترة حسب سمات المركبة
يمكنك أيضًا استخدام هذه الطريقة لتطبيق فلتر على سمات المركبة، والتي تعمل كعامل تشغيل AND عند استخدامها مع مواصفات الحقول الأخرى. للحصول على تفاصيل حول بنية طلب البحث الخاص بالفلتر، يُرجى الاطّلاع على الفلترة: 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