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

הערה: לפני שיוצרים בקשה לכלי רכב, צריך לקרוא את הדרישות בקטע בקשות לכלי רכב במבוא.

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

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

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

דוגמה לפרסום רכב

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

אפשר להשתמש ב-gRPC client libraries או ב-REST.

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

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

• חיפוש כלי רכב