إدراج مركبات

استخدام الطريقة 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

الخطوات التالية