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

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

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