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

משתמשים ב-method‏ ListVehicles כדי למצוא את כל הרכבים שעומדים באפשרויות ספציפיות של בקשה. ה-method‏ ListVehicles מחזירה רשימה מחולקת לדפים של כלי הרכב בפרויקט שתואמים לשאילתות בשדות של כלי הרכב.

סינון לפי מאפייני הרכב

אפשר להשתמש בשיטה הזו גם כדי לסנן לפי מאפייני רכב, שפועלים כאופרטור AND כשמשתמשים בהם בשילוב עם מפרטי שדות אחרים. לפרטים על התחביר של שאילתות סינון, ראו דוגמאות במאמר סינון: AIP-160. פרטים על יצירת מאפייני רכב מופיעים בקטע שדה מאפייני הרכב במדריך עדכון שדות של רכב.

דוגמה לרכב ברשימה

בדוגמה הזו, הסינון מתבצע גם בשדה vehicle_type וגם בשדה attributes באמצעות המחרוזת filter, כך שמוצגים רק כלי רכב מסוג AUTO ומתקבל הערך LUXURY במאפיין המותאם אישית class.

אפשר להשתמש ב-REST או בספריות הלקוח של gRPC.

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

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