যানবাহন অনুসন্ধান করুন

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

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

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

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

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

অনুসন্ধান যানবাহন অনুরোধ ক্ষেত্র

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

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

অনুসন্ধানযানবাহনঅনুরোধের পরিস্থিতি

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

উদাহরণস্বরূপ, ধরুন একজন গ্রাহক RestaurantX থেকে তাকে নিতে চান, এবং আপনার কাছে চারটি গাড়ি আছে:

• গাড়ি ১ : রেস্তোরাঁএক্স থেকে ৩৫০০ মিটার দূরে।
• যানবাহন ২ : RestaurantX থেকে ১০০ মিটার দূরে, A এবং B অবস্থানে পিকআপ এবং ড্রপ সহ একটি সক্রিয় ট্রিপ।
• গাড়ি ৩ : রেস্তোরাঁএক্স থেকে ২০০ মিটার দূরে এবং একটি ড্রপ অফ অনেক দূরে।
• গাড়ি ৪ : রেস্তোরাঁএক্স থেকে ১০০০ মিটার দূরে।

নিম্নলিখিতটি তাদের ফেরত পাঠানো গাড়ির বিভিন্ন অনুরোধ প্রদর্শন করে।

     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 সত্তার একটি তালিকা থাকে, যা SearchVehiclesRequest এ নির্দিষ্ট order_by অ্যাট্রিবিউট অনুসারে র‍্যাঙ্ক করা হয়। প্রতিটি VehicleMatch সত্তার নিম্নলিখিত ক্ষেত্রগুলি থাকে:

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

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

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

SearchVehicles এবং ListVehicles ফিল্টার কোয়েরি ব্যবহার করে গাড়ির বৈশিষ্ট্যগুলিতে ফিল্টারিং সমর্থন করে।

ফিল্টার কোয়েরি শুধুমাত্র যানবাহনের জন্য কাস্টম অ্যাট্রিবিউটের ফিল্টারিং সমর্থন করে এবং অন্যান্য ক্ষেত্রে ব্যবহার করা যাবে না। যখন এমন কোনও অনুসন্ধানে ব্যবহার করা হয় যেখানে অন্যান্য ক্ষেত্রের মানদণ্ড অন্তর্ভুক্ত থাকে, যেমন minimum_capacity বা vehicle_types , তখন ফিল্টার কোয়েরি একটি AND ধারা হিসেবে কাজ করে।

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

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

অনুসন্ধান যানবাহনের উদাহরণ

নিম্নলিখিত উদাহরণে জাভা 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.

এরপর কি?

• যানবাহন মুছুন