משתמשים בשיטה 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