استخدِم الطريقة 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