إدراج مركبات

استخدِم طريقة ListVehicles للعثور على جميع المركبات التي تستوفي بعض خيارات الطلبات المحدّدة. تعرض الطريقة ListVehicles قائمة مقسّمة على صفحات للمركبات في المشروع التي تتطابق مع طلبات البحث في حقول المركبات.

الفلترة حسب سمات المركبات

يمكنك أيضًا استخدام هذه الطريقة للفلترة حسب سمات المركبات، والتي تعمل كعامل تشغيل AND عند استخدامها مع مواصفات الحقول الأخرى. للاطّلاع على تفاصيل حول بنية طلب البحث في الفلتر، يُرجى مراجعة الفلترة: AIP-160 للحصول على أمثلة. للحصول على تفاصيل حول إنشاء سمات المركبات، يُرجى الاطّلاع على حقل سمات المركبات في دليل تعديل حقول المركبات.

مثال على بيانات المركبة

يُجري هذا المثال فلترة على كلّ من الحقلَين vehicle_type وattributes باستخدام السلسلة filter، ويعرض فقط المركبات من النوع AUTO ويحصل على القيمة LUXURY للسمة المخصّصة class.

يمكنك استخدام مكتبات برامج gRPC أو REST.

جافا

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

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