রুটিং সারাংশের সাথে রুট বরাবর অনুসন্ধান একত্রিত করুন

আপনি রুটিং সারাংশ গণনার সাথে একটি রুট বরাবর অনুসন্ধানকে একত্রিত করতে পারেন। এক্ষেত্রে, টেক্সট সার্চ (নতুন) প্রতিক্রিয়ার প্রতিটি স্থানে যাওয়ার ভ্রমণের সময়কাল ও দূরত্ব এবং তারপর প্রতিটি স্থান থেকে রুটের চূড়ান্ত গন্তব্য পর্যন্ত ভ্রমণের সময়কাল ও দূরত্ব ফেরত দেয়।

একটি রুট বরাবর অনুসন্ধানের পাশাপাশি রাউটিং সারাংশ গণনা করতে টেক্সট সার্চ (নতুন) ব্যবহার করতে:

1. Routes API ব্যবহার করে এমন একটি রাউট গণনা করুন যা রেসপন্সে একটি রাউট পলিলাইন ফেরত দেয় ।

2. সার্চের ফলাফলকে নির্দিষ্ট রুটের দিকে পক্ষপাতদুষ্ট করতে, টেক্সট সার্চ (নতুন)-এ রুট পলিলাইনটি পাস করার জন্য searchAlongRouteParameters.polyline.encodedPolyline প্যারামিটারটি ব্যবহার করুন। এর ফলে প্রাপ্ত ফলাফলে সেইসব স্থানের তথ্য থাকবে, যেগুলো সার্চের শর্ত পূরণ করে এবং নির্দিষ্ট রুটের কাছাকাছি অবস্থিত।

3. ফিল্ড মাস্কে routingSummaries অন্তর্ভুক্ত করুন, যাতে রেসপন্সে routingSummaries অ্যারেটি অন্তর্ভুক্ত থাকে। এই অ্যারেটিতে রেসপন্সের প্রতিটি স্থানের জন্য রাউটিং অরিজিন থেকে সময়কাল এবং দূরত্ব থাকে।

এপিআই এক্সপ্লোরার আপনাকে সরাসরি অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন:

ডিফল্টরূপে, টেক্সট সার্চ (নতুন) সম্পূর্ণ রুট জুড়ে অনুসন্ধানটি সম্পাদন করে:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "searchAlongRouteParameters": {
    "polyline": {
      "encodedPolyline": "ROUTE_POLYLINE"
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

প্রতিক্রিয়াটিতে দুটি অ্যারে রয়েছে: ' places অ্যারে, যাতে মিলে যাওয়া স্থানগুলি থাকে, এবং routingSummaries অ্যারে, যাতে প্রতিটি স্থানে পৌঁছানোর সময়কাল ও দূরত্ব থাকে।

{
  "places": [
    {
      "formattedAddress": "1199 El Camino Real, San Bruno, CA 94066, USA",
      "priceLevel": "PRICE_LEVEL_INEXPENSIVE",
      "displayName": {
        "text": "Vegan Mob - Vegan BBQ and Soul Food",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "839 Kearny St, San Francisco, CA 94108, USA",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Enjoy Vegetarian",
        "languageCode": "en"
      }
    },
   …
],
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "285s",
          "distanceMeters": 1616
        },
        {
          "duration": "2466s",
          "distanceMeters": 58147
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/37.42268,-122.08473/''/37.77877,-122.38781/data=!4m7!4m6!1m0!1m2!1m1!1s0x808f87f9ede375f5:0xa37171fea1a16b28!1m0!3e0"
    },
    {
      "legs": [
        {
          "duration": "696s",
          "distanceMeters": 4704
        },
        {
          "duration": "2787s",
          "distanceMeters": 58901
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/37.42268,-122.08473/''/37.77877,-122.38781/data=!4m7!4m6!1m0!1m2!1m1!1s0x808580f4cebdb06f:0xd3af09e5742234f2!1m0!3e0"
    },
   …
  ]
}

legs অ্যারের প্রতিটি এন্ট্রির জন্য, Text Search (New) দুই-লেগের ভ্রমণের সময় ফেরত দেয়:

• প্রথম অংশে উৎস থেকে গন্তব্যস্থল পর্যন্ত ভ্রমণের সময়কাল এবং দূরত্ব উল্লেখ থাকে। এই উদাহরণে, উৎস থেকে ফলাফলের প্রথম স্থান পর্যন্ত ভ্রমণের সময়কাল ও দূরত্ব হলো ২৮৫ সেকেন্ড এবং ১৬১৬ মিটার।

• দ্বিতীয় ধাপে স্থান থেকে পথের গন্তব্য পর্যন্ত ভ্রমণের সময়কাল এবং দূরত্ব উল্লেখ থাকে। এই উদাহরণে, সময়কাল ও দূরত্ব হলো ২৪৬৬ সেকেন্ড এবং ৫৮১৪৭ মিটার।

রাউটিংয়ের উৎস, ভ্রমণ পদ্ধতি এবং রুট মডিফায়ার নির্দিষ্ট করুন।

আপনি রাউটিং অরিজিন, ট্র্যাভেল মোড, রুট মডিফায়ার এবং রাউটিং প্রেফারেন্স উল্লেখ করে সার্চ ও রাউটিং সামারি ক্যালকুলেশন পরিবর্তন করতে পারেন। ট্র্যাভেল মোড এবং রুট মডিফায়ারগুলো, 'স্পেসিফাই ট্র্যাভেল অপশনস' টপিকে দেখানো অনুযায়ী, কোনো রুট উল্লেখ না করে রাউটিং সামারি গণনার মতোই কাজ করে।

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

পরবর্তী উদাহরণে, আপনি রাউটিংয়ের উৎস হিসেবে ক্যালিফোর্নিয়ার সান মাতেও-এর স্থানাঙ্ক নির্দিষ্ট করবেন, টোল এড়ানোর নির্দেশ দেবেন এবং ফলাফলের সংখ্যা ৫-এ সেট করবেন:

  curl -X POST -d '{
    "textQuery" : "Spicy Vegetarian Food",
    "maxResultCount": 5,
    "searchAlongRouteParameters": {
      "polyline": {
        "encodedPolyline": "ROUTE_POLYLINE"
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": 37.56617,
        "longitude": -122.30870
      },
      "travelMode":"DRIVE",
      "routeModifiers": {
        "avoidTolls": true
      }
    }
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
  -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
  'https://places.googleapis.com/v1/places:searchText'

নিচের ছবিতে একটি মানচিত্র দেখানো হয়েছে, যাতে রুটের পলিলাইন, নতুন উৎস (হালকা-নীল পিন) এবং অনুসন্ধানের ফলাফলে থাকা স্থানগুলো (সবুজ পিন) রয়েছে। লক্ষ্য করুন, সমস্ত ফলাফল রুট বরাবর, কিন্তু সান মাতেও-এর পরে অবস্থিত:

চেষ্টা করে দেখুন!

এপিআই এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন।

1. পৃষ্ঠার ডানদিকে থাকা API আইকনটি (api) নির্বাচন করুন।

2. ইচ্ছা হলে অনুরোধের প্যারামিটারগুলো সম্পাদনা করুন।

3. Execute বাটনটি নির্বাচন করুন। প্রদর্শিত ডায়ালগ বক্সে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান, সেটি বেছে নিন।

4. এপিআই এক্সপ্লোরার প্যানেলে, এপিআই এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকনটি নির্বাচন করুন।