جستجوی وسایل نقلیه

به عنوان بخشی از سرویس سفر درخواستی Mobility، می‌توانید با استفاده از متد SearchVehicles ، خودروهای نزدیک را پیدا کنید.

متد SearchVehicles به شما امکان می‌دهد خودروهای موجود در نزدیکی خود را که برای یک سفر خاص یا درخواست تحویل مناسب‌تر هستند، در برنامه تلفن همراه مصرف‌کننده خود پیدا کنید. API SearchVehicles لیستی رتبه‌بندی‌شده از خودروهایی را که ویژگی‌های آنها با ویژگی‌های سفر درخواستی مطابقت دارد، برمی‌گرداند. رتبه‌بندی بر اساس انتخاب شما از ETA، مسافت یا فاصله مستقیم از نقطه تحویل سفارش، مرتب می‌شود.

از متد SearchVehicles استفاده کنید

برای استفاده از SearchVehicles ، این فرآیند کلی را دنبال کنید:

1. بر اساس سفری که قرار است اختصاص داده شود، یک SearchVehiclesRequest ایجاد کنید.
2. با درخواست ساخته شده، API SearchVehicles ( vehicleService.searchVehicles ) را فراخوانی کنید.
3. پردازش SearchVehicleResponse برگردانده شده از API.

جستجووسایل نقلیهفیلدهای درخواست

از فیلدهای ویژگی الزامی زیر برای ساخت یک SearchVehiclesRequest استفاده کنید:

برای مشاهده‌ی مجموعه‌ی کامل فیلدهای SearchVehicleRequest به مستندات مرجع مراجعه کنید.

جستجووسایل نقلیهدرخواست سناریوها

این بخش نمونه‌هایی از نحوه ساخت یک SearchVehiclesRequest را نشان می‌دهد.

برای مثال، فرض کنید مشتری می‌خواهد از رستوران ایکس سوار شود و شما چهار وسیله نقلیه دارید:

• وسیله نقلیه ۱ : ۳۵۰۰ متر دورتر از رستوران X.
• وسیله نقلیه ۲ : ۱۰۰ متر دورتر از رستوران X با یک سفر فعال با سرویس سوار و پیاده شدن در مکان‌های A و B.
• وسیله نقلیه ۳ : ۲۰۰ متر با رستوران ایکس فاصله دارد و یک ایستگاه پیاده شدن خیلی دور باقی مانده است.
• وسیله نقلیه ۴ : ۱۰۰۰ متر دورتر از رستوران X.

موارد زیر درخواست‌های مختلفی را که توسط وسیله نقلیه‌ای که برمی‌گردانند نمایش می‌دهد.

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA
    

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, is_back_to_back enabled
    

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, current_trips_present = ALL
    

جستجووسایل نقلیهفیلدهای پاسخ

یک SearchVehiclesResponse شامل فهرستی از موجودیت‌های VehicleMatch است که بر اساس ویژگی order_by مشخص شده در SearchVehiclesRequest رتبه‌بندی شده‌اند. هر موجودیت VehicleMatch دارای فیلدهای زیر است:

برای فهرست کاملی از فیلدهای VehicleMatch ، به لینک زیر مراجعه کنید:

• VehicleMatch message (gRPC)
• VehicleMatch resource (REST)

استفاده از پرس‌وجوهای فیلتر

SearchVehicles و ListVehicles از فیلتر کردن ویژگی‌های خودرو با استفاده از یک پرس‌وجوی فیلتر پشتیبانی می‌کنند.

پرس‌وجوهای فیلتر فقط از فیلتر کردن ویژگی‌های سفارشی برای وسایل نقلیه پشتیبانی می‌کنند و نمی‌توانند برای فیلدهای دیگر استفاده شوند. وقتی در جستجویی استفاده می‌شوند که شامل معیارهای فیلد دیگری مانند minimum_capacity یا vehicle_types است، پرس‌وجوی فیلتر مانند یک عبارت AND عمل می‌کند.

برای مثال، اگر به دنبال وسیله نقلیه‌ای با حداقل ظرفیت ۶ نفر باشید و attributes مانند «مناسب برای حیوانات خانگی» را فیلتر کنید، معیارهای شما فقط وسایل نقلیه‌ای را برمی‌گرداند که هم مناسب برای حیوانات خانگی باشند و هم بتوانند حداقل ۶ مسافر را حمل کنند.

برای مشاهده‌ی سینتکس پرس‌وجوی فیلتر، به مثال‌های AIP-160 مراجعه کنید. برای جزئیات بیشتر در مورد ایجاد ویژگی‌های وسیله نقلیه، به فیلد ویژگی‌های وسیله نقلیه در راهنمای به‌روزرسانی فیلدهای وسیله نقلیه مراجعه کنید.

مثال جستجوی وسایل نقلیه

مثال زیر نحوه استفاده از API SearchVehicles با استفاده از کتابخانه جاوا gRPC نشان می‌دهد.

static final String PROJECT_ID = "project-id";

VehicleServiceBlockingStub vehicleService =
    VehicleService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;
SearchVehiclesRequest searchVehiclesRequest = SearchVehiclesRequest.newBuilder()
    .setParent(parent)
    .setPickupPoint( // Grand Indonesia East Mall
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint( // Balai Sidang Jkt Convention Center
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder().setLatitude(-6.213796).setLongitude(106.807195)))
    .setPickupRadiusMeters(2000)
    .setCount(10)
    .setMinimumCapacity(2)
    .addTripTypes(TripType.EXCLUSIVE)
    .addVehicleTypes(VehicleType.newBuilder().setCategory(Category.AUTO).build())
    .setCurrentTripsPresent(CurrentTripsPresent.ANY)
    .setFilter("attributes.on_trip=\"false\"")
    .setOrderBy(VehicleMatchOrder.PICKUP_POINT_ETA)
    .build();

try {
  SearchVehiclesResponse searchVehiclesResponse =
      vehicleService.searchVehicles(searchVehiclesRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

List<VehicleMatch> vehicleMatches =
    searchVehicleResponse.getMatchesList();

// Each VehicleMatch contains a Vehicle entity and information about the
// distance and ETA to the pickup point and drop-off point.

قدم بعدی چیست؟

• حذف وسیله نقلیه