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

রেসপন্সের প্রতিটি স্থানের ভ্রমণের সময়কাল ও দূরত্ব গণনা করতে টেক্সট সার্চ (নতুন) বা নিয়ারবাই সার্চ (নতুন) ব্যবহার করুন:

  1. রাউটিং অরিজিনের অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক নির্দিষ্ট করতে রিকোয়েস্টে routingParameters.origin প্যারামিটারটি পাস করুন। রেসপন্সের প্রতিটি স্থানের সময়কাল ও দূরত্ব গণনা করার জন্য এই প্যারামিটারটি আবশ্যক।

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

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

টেক্সট সার্চ ব্যবহার করুন (নতুন)

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

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    }
  }
}' \
-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'

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

{
  "places": [
    {
      object (Place)
    }
  ]
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
}

routingSummaries অ্যারের প্রতিটি উপাদান places অ্যারের স্থানের সাথে সংশ্লিষ্ট অ্যারে অবস্থানে থাকে। অর্থাৎ, routingSummaries[0] এর উপাদানটি places[0] এর স্থানের সাথে সঙ্গতিপূর্ণ।

routingSummaries এর অ্যারের দৈর্ঘ্য places এর অ্যারের দৈর্ঘ্যের সমান। যদি কোনো স্থানের জন্য routingSummary উপলব্ধ না থাকে, তবে অ্যারের এন্ট্রিটি খালি থাকে।

যেহেতু এই উদাহরণটি রাউটিং উৎস থেকে প্রতিটি স্থানের সময়কাল এবং দূরত্ব গণনা করে, তাই প্রতিক্রিয়ার routingSummaries.legs ফিল্ডটিতে একটি একক Leg অবজেক্ট থাকে, যেটিতে রাউটিং উৎস থেকে সেই স্থান পর্যন্ত duration এবং distanceMeters অন্তর্ভুক্ত থাকে।

{
  "places": [
    {
      "formattedAddress": "1, Westfield Sydney Central Plaza, 450 George St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Gözleme King Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    …
  ]
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "597s",
          "distanceMeters": 2607
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3fa97cd745:0x6aecf365bf497c08!3e0"
    },
    {
      "legs": [
        {
          "duration": "562s",
          "distanceMeters": 2345
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3da97f60c1:0x845f3273bd764f6c!3e0"
    },
   …
  ]
}

এই উদাহরণ থেকে আপনি দেখতে পাচ্ছেন যে, রাউটিংয়ের উৎস থেকে ফলাফলের প্রথম স্থান পর্যন্ত সময়কাল এবং দূরত্ব হলো ৫৯৭ সেকেন্ড এবং ২৬০৭ মিটার।

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

  curl -X POST -d '{
    "includedTypes": ["restaurant"],
    "maxResultCount": 10,
    "locationRestriction": {
      "circle": {
        "center": {
          "latitude": -33.8688,
          "longitude": 151.1957362},
        "radius": 500.0
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": -33.8688,
        "longitude": 151.1957362
      }
    }
  }' \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key:API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,routingSummaries" \
  https://places.googleapis.com/v1/places:searchNearby

locationRestriction এবং routing origin-এর জন্য আপনাকে একই স্থানাঙ্ক ব্যবহার করতে হবে না। উদাহরণস্বরূপ, আপনি অনুসন্ধানের ফলাফলকে ওই বৃত্তের দিকে পক্ষপাতদুষ্ট করতে locationRestriction সিডনির কেন্দ্রবিন্দুতে সেট করলেন। কিন্তু এরপর আপনি routing origin-কে আপনার বাড়ির স্থানাঙ্কে সেট করলেন, অর্থাৎ অনুসন্ধানের বৃত্তের মধ্যে একটি ভিন্ন অবস্থানে। তখন অনুরোধটি অনুসন্ধানের ফলাফলকে ওই বৃত্তের দিকে পক্ষপাতদুষ্ট করে এবং আপনার বাড়ির অবস্থানের উপর ভিত্তি করে রাউটিং সারাংশ গণনা করে।

ভ্রমণের বিকল্পগুলি নির্দিষ্ট করুন

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

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

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    },
    "travelMode":"DRIVE",
    "routeModifiers": {
      "avoidHighways": 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. এপিআই এক্সপ্লোরার প্যানেলে, এপিআই এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকনটি নির্বাচন করুন।

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