গাড়ি সার্চ করুন

মোবিলিটি অন-ডিমান্ড ট্রিপ পরিষেবার অংশ হিসেবে, আপনি SearchVehicles পদ্ধতি ব্যবহার করে আশেপাশের গাড়ি খুঁজে পেতে পারেন।

SearchVehicles পদ্ধতি আপনাকে গ্রাহকের মোবাইল অ্যাপে কাছাকাছি উপলভ্য এমন গাড়ি খুঁজে পেতে সাহায্য করে যা নির্দিষ্ট রাইড বা ডেলিভারির অনুরোধের জন্য সবচেয়ে উপযুক্ত। SearchVehicles API এমন সব গাড়ির র‍্যাঙ্ক করা তালিকা দেখায় যেগুলির অ্যাট্রিবিউট অনুরোধ করা ট্রিপের অ্যাট্রিবিউটের সাথে মিলে যায়। আপনার বেছে নেওয়া ETA, দূরত্ব বা পিক-আপ পয়েন্ট থেকে সরলরেখায় দূরত্বের ভিত্তিতে র‍্যাঙ্কিং সাজানো হয়।

SearchVehicles পদ্ধতি ব্যবহার করুন

SearchVehicles ব্যবহার করতে, এই সাধারণ প্রসেস অনুসরণ করুন:

1. অ্যাসাইন করা ট্রিপের উপর ভিত্তি করে একটি SearchVehiclesRequest তৈরি করুন।
2. তৈরি করা অনুরোধের মাধ্যমে SearchVehicles API (vehicleService.searchVehicles) কল করুন।
3. API থেকে ফেরত আসা SearchVehicleResponse প্রসেস করুন।

SearchVehiclesRequest ফিল্ড

SearchVehiclesRequest তৈরি করতে নিম্নলিখিত প্রয়োজনীয় অ্যাট্রিবিউট ফিল্ড ব্যবহার করুন:

SearchVehicleRequest ফিল্ডের সম্পূর্ণ সেট দেখতে রেফারেন্স ডকুমেন্টেশন দেখুন।

SearchVehiclesRequest সিনারিও

এই বিভাগে SearchVehiclesRequest কীভাবে তৈরি করতে হয় তার উদাহরণ দেখানো হয়েছে।

যেমন, ধরুন কোনও গ্রাহক RestaurantX থেকে পিক-আপ চান, এবং আপনার কাছে চারটি গাড়ি আছে:

• গাড়ি ১: RestaurantX থেকে ৩৫০০ মিটার দূরে।
• গাড়ি ২: RestaurantX থেকে ১০০ মিটার দূরে, একটি অ্যাক্টিভ ট্রিপে আছে, পিক-আপ ও ড্রপ-অফ লোকেশন যথাক্রমে A ও B.
• গাড়ি ৩: RestaurantX থেকে ২০০ মিটার দূরে, একটি ড্রপ-অফ বাকি আছে যা অনেক দূরে।
• গাড়ি ৪: RestaurantX থেকে ১০০০ মিটার দূরে।

গাড়িটি যে ধরনের অনুরোধ ফেরত পাঠায়, তার বিভিন্ন উদাহরণ নিচে দেওয়া হল।

     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 ফিল্ড

SearchVehiclesResponse-এ VehicleMatch এন্টিটির তালিকা থাকে, যা SearchVehiclesRequest-এ নির্দিষ্ট করা order_by অ্যাট্রিবিউট অনুযায়ী র‍্যাঙ্ক করা হয়। প্রতিটি VehicleMatch এন্টিটিতে নিম্নলিখিত ফিল্ড আছে:

VehicleMatch ফিল্ডের সম্পূর্ণ তালিকা দেখতে, এখানে যান:

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

ফিল্টার কোয়েরি ব্যবহার করুন

SearchVehicles এবং ListVehicles ফিল্টার কোয়েরি ব্যবহার করে গাড়ির অ্যাট্রিবিউটের উপর ফিল্টার করার সুবিধা দেয়।

ফিল্টার কোয়েরি শুধুমাত্র গাড়ির কাস্টম অ্যাট্রিবিউটের উপর ফিল্টারিং সমর্থন করে এবং অন্যান্য ফিল্ডের জন্য ব্যবহার করা যাবে না। অন্য ফিল্ডের মাপকাঠি সহ সার্চে ব্যবহার করা হলে, যেমন minimum_capacity বা vehicle_types, ফিল্টার কোয়েরি AND ক্লজ হিসেবে কাজ করে।

যেমন, আপনি যদি এমন কোনও গাড়ি সার্চ করেন যাতে কমপক্ষে ৬ জন বসতে পারেন এবং পোষ্য-বান্ধবের মতো attributes ফিল্টার করেন, তাহলে আপনার সার্চের ফলাফলে শুধু সেইসব গাড়িই দেখানো হবে যেগুলি পোষ্য-বান্ধব এবং কমপক্ষে ৬ জন যাত্রী বহন করতে পারে।

ফিল্টার কোয়েরি সিনট্যাক্সের জন্য, উদাহরণ হিসেবে AIP-160 দেখুন। গাড়ির অ্যাট্রিবিউট তৈরি করার ব্যাপারে বিস্তারিত জানতে, গাড়ির ফিল্ড আপডেট করুন গাইডে গাড়ির অ্যাট্রিবিউট ফিল্ড দেখুন।

SearchVehicles Example

Java gRPC লাইব্রেরি ব্যবহার করে কীভাবে SearchVehicles API ব্যবহার করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। যেসব ভাষায় উপলভ্য তার সম্পূর্ণ তালিকা দেখতে, অন-ডিমান্ড ট্রিপ পরিষেবার জন্য ক্লায়েন্ট লাইব্রেরি দেখুন।

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.

এর পরে কী করতে হবে

• DeleteVehicle