הצגת רשימה של כלי רכב

צריך להשתמש בשיטה 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

המאמרים הבאים