রাউটিং সারাংশ গণনা করুন

প্রতিক্রিয়ায় প্রতিটি স্থানে ভ্রমণের সময়কাল এবং দূরত্ব গণনা করতে পাঠ্য অনুসন্ধান (নতুন) বা কাছাকাছি অনুসন্ধান (নতুন) ব্যবহার করতে:

1. রাউটিং মূলের অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক নির্দিষ্ট করতে setOrigin() ব্যবহার করে অনুরোধে RoutingParameters প্যারামিটারটি পাস করুন। এই প্যারামিটারটি প্রতিক্রিয়াতে প্রতিটি স্থানের সময়কাল এবং দূরত্ব গণনা করার জন্য প্রয়োজন।

2. অনুরোধ অবজেক্ট তৈরি করার সময়, .setRoutingSummariesIncluded(true) যোগ করুন।

পাঠ্য অনুসন্ধান ব্যবহার করুন (নতুন)

নিম্নলিখিত অনুরোধে, আপনি পাঠ্য অনুসন্ধান (নতুন) প্রতিক্রিয়াতে প্রতিটি স্থানের ভ্রমণের সময়কাল এবং দূরত্ব গণনা করুন:

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Define the routing parameters object and pass the routing origin.
RoutingParameters routingParameters = RoutingParameters.builder()
    .setOrigin(toLatLng("-33.8688, 151.1957362"))
    .build();

// Use the builder to create a SearchByTextRequest object and pass the routing parameters.
// Set setRoutingSummariesIncluded to true.
final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food in Sydney, Australia", placeFields)
    .setMaxResultCount(10)
    .setRoutingParameters(routingParameters)
    .setRoutingSummariesIncluded(true)
    .build();

// Call PlacesClient.searchByText() to perform the search.
// Define a response handler to process the returned Lists of Place objects, RoutingSummary objects, and Leg objects.
placesClient.searchByText(searchByTextRequest)   
    .addOnSuccessListener(response -> {
      List<Place> places = response.getPlaces();
      List<RoutingSummary> routingSummaries = response.getRoutingSummaries();
      List<Leg> legs = routingSummaries.get(0).getLegs();
      Duration duration = legs.get(0).getDuration();
    });

SearchByTextResponse ক্লাস একটি অনুসন্ধান অনুরোধ থেকে প্রতিক্রিয়া প্রতিনিধিত্ব করে। আপনি রাউটিং সারাংশের তালিকা ফেরত দিতে SearchByTextResponse.getRoutingSummaries() কল করতে পারেন। একটি SearchByTextResponse অবজেক্টেও রয়েছে:

• Place অবজেক্টের একটি তালিকা যা সমস্ত মিলে যাওয়া জায়গাগুলিকে প্রতিনিধিত্ব করে, প্রতি মিলিত জায়গায় একটি Place অবজেক্ট সহ।
• প্রতিটি Place অবজেক্ট শুধুমাত্র অনুরোধে পাস করা ক্ষেত্র তালিকা দ্বারা সংজ্ঞায়িত ক্ষেত্র ধারণ করে।

দ্রষ্টব্য: প্রতিক্রিয়াটিতে শুধুমাত্র প্রতিটি স্থানের duration এবং distanceMeters রয়েছে৷ এটি প্রকৃত রুট নিজেই ধারণ করে না। রুট গণনা করতে, রুট API ব্যবহার করুন, এটিতে গন্তব্য স্থানের উৎপত্তি এবং অবস্থান পাস করুন।

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

এই উদাহরণে, আপনি কাছাকাছি অনুসন্ধান প্রতিক্রিয়াতে প্রতিটি স্থানের ভ্রমণের সময়কাল এবং দূরত্ব গণনা করেন। এই উদাহরণটি অস্ট্রেলিয়ার সিডনিতে রেস্তোরাঁর জন্য অনুসন্ধান করে এবং অবস্থানের সীমাবদ্ধতা এবং একই অক্ষাংশ এবং দ্রাঘিমাংশের সমন্বয়ে রাউটিং উত্স সেট করে:

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Define the search area as a 500 meter diameter circle in Sydney, Australia.
LatLng center = new LatLng(-33.8688, 151.1957362);
CircularBounds circle = CircularBounds.newInstance(center, /* radius = */ 500);

// Define the routing parameters object and pass the routing origin.
RoutingParameters routingParameters = RoutingParameters.builder()
    .setOrigin(toLatLng("-33.8688, 151.1957362"))
    .build();

// Use the builder to create a SearchNearbyRequest object and pass the routing parameters.
// Set setRoutingSummariesIncluded to true.
final SearchNearbyRequest searchNearbyRequest =
SearchNearbyRequest.builder(/* location restriction = */ circle, placeFields)
    .setIncludedTypes(includedTypes)
    .setMaxResultCount(10)
    .setRoutingParameters(routingParameters)
    .setRoutingSummariesIncluded(true)
    .build();

// Call PlacesClient.searchNearby() to perform the search.
// Define a response handler to process the returned Lists of Place objects, RoutingSummary objects, and Leg objects.
placesClient.searchNearby(searchNearbyRequest)
    .addOnSuccessListener(response -> {
      List<Place> places = response.getPlaces();
      List<RoutingSummary> routingSummaries = response.getRoutingSummaries();
      List<Leg> legs = routingSummaries.get(0).getLegs();
      Duration duration = legs.get(0).getDuration();
    });

SearchNearbyResponse ক্লাস একটি অনুসন্ধান অনুরোধ থেকে প্রতিক্রিয়া প্রতিনিধিত্ব করে। আপনি রাউটিং সারাংশের তালিকা ফেরত দিতে SearchNearbyResponse.getRoutingSummaries() কল করতে পারেন। একটি SearchNearbyResponse অবজেক্টেও রয়েছে:

• Place অবজেক্টের একটি তালিকা যা সমস্ত মিলে যাওয়া জায়গাগুলিকে প্রতিনিধিত্ব করে, প্রতি মিলিত জায়গায় একটি Place অবজেক্ট সহ।
• প্রতিটি Place অবজেক্ট শুধুমাত্র অনুরোধে পাস করা ক্ষেত্র তালিকা দ্বারা সংজ্ঞায়িত ক্ষেত্র ধারণ করে।

অবস্থানের সীমাবদ্ধতা এবং রাউটিং মূলের জন্য আপনাকে একই স্থানাঙ্ক ব্যবহার করতে হবে না। উদাহরণ স্বরূপ, আপনি সেই বৃত্তে অনুসন্ধান ফলাফল সীমাবদ্ধ করতে সিডনির কেন্দ্র বিন্দুতে অবস্থানের সীমাবদ্ধতা সেট করেছেন৷ কিন্তু তারপরে আপনি আপনার বাড়ির স্থানাঙ্কে রাউটিং উত্স সেট করেছেন, যার অর্থ অনুসন্ধান বৃত্তের মধ্যে একটি ভিন্ন অবস্থানে৷ অনুরোধটি সার্চের ফলাফলগুলিকে বৃত্তের মধ্যে সীমাবদ্ধ করে এবং আপনার বাড়ির অবস্থানের উপর ভিত্তি করে রাউটিং সারাংশ গণনা করে৷

ভ্রমণের বিকল্পগুলি উল্লেখ করুন

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

• DRIVE , BICYCLE , WALK বা TWO_WHEELER এ পরিবহনের মোড সেট করতে routingParameters.setTravelMode() ব্যবহার করুন। এই বিকল্পগুলি সম্পর্কে আরও তথ্যের জন্য, রুটের জন্য উপলব্ধ গাড়ির ধরন দেখুন।

  দ্রষ্টব্য: Routes API TRANSIT এর একটি মোডকেও সমর্থন করে, কিন্তু সেই মোডটি Places API দ্বারা সমর্থিত নয়৷
  দ্রষ্টব্য: TWO_WHEELER বিকল্পটি কেবলমাত্র সেই দেশগুলিতে সমর্থিত যে দেশগুলি এবং অঞ্চলগুলিতে তালিকাভুক্ত দুই চাকার যানবাহনের জন্য সমর্থিত ৷
• TRAFFIC_UNAWARE (ডিফল্ট), TRAFFIC_AWARE , বা TRAFFIC_AWARE_OPTIMAL এ রাউটিং পছন্দ বিকল্প সেট করতে routingParameters.setRoutingPreference() ব্যবহার করুন। প্রতিটি বিকল্পের ডেটা গুণমান এবং লেটেন্সির বিভিন্ন স্তর রয়েছে৷ আরও তথ্যের জন্য, কীভাবে এবং যদি ট্র্যাফিক ডেটা অন্তর্ভুক্ত করতে হয় তা নির্দিষ্ট করুন দেখুন।
• routingParameters.setRouteModifiers() ব্যবহার করুন avoidTolls , avoidHighways , avoidFerries এবং avoidIndoor জন্য নির্দিষ্ট করতে। এই বিকল্পগুলি সম্পর্কে আরও তথ্যের জন্য, এড়াতে রুট বৈশিষ্ট্যগুলি নির্দিষ্ট করুন দেখুন৷

পরবর্তী উদাহরণে, আপনি DRIVE হিসাবে ভ্রমণ মোড নির্দিষ্ট করুন এবং হাইওয়ে এড়াতে:

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Define the routing modifiers object.
RouteModifiers routeModifiers = RouteModifiers.builder()
    .setAvoidHighways(true)
    .build();

// Define the routing parameters object and pass the routing origin.
RoutingParameters routingParameters = RoutingParameters.builder()
    .setOrigin(toLatLng("-33.8688, 151.1957362"))
    .setTravelMode(DRIVE)
    .setRouteModifiers(routeModifiers)
    .build();

// Use the builder to create a SearchByTextRequest object and pass the routing parameters.
// Set setRoutingSummariesIncluded to true.
final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food in Sydney, Australia", placeFields)
    .setMaxResultCount(10)
    .setRoutingParameters(routingParameters)
    .setRoutingSummariesIncluded(true)
    .build();

// Call PlacesClient.searchByText() to perform the search.
// Define a response handler to process the returned Lists of Place objects, RoutingSummary objects, and Leg objects.
placesClient.searchByText(searchByTextRequest)   
    .addOnSuccessListener(response -> {
      List<Place> places = response.getPlaces();
      List<RoutingSummary> routingSummaries = result.getRoutingSummaries();
      List<Leg> legs = routingSummaries.get(0).getLegs();
      Duration duration = legs.get(0).getDuration();
    });