রাউটিংয়ের সারসংক্ষেপ গণনা করুন

উত্তরে প্রতিটি জায়গায় যাওয়ার সময় ও দূরত্ব গণনা করতে Text Search (New) বা Nearby Search (New) ব্যবহার করতে:

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

2. ফিল্ড মাস্কে routingSummaries অন্তর্ভুক্ত করুন যাতে উত্তরে routingSummaries অ্যারে অন্তর্ভুক্ত থাকে। এই অ্যারেতে রাউটিংয়ের উৎস থেকে উত্তরে দেখানো প্রতিটি জায়গার দূরত্ব ও সেখানে পৌঁছাতে কত সময় লাগবে তা দেখানো হয়।

APIs Explorer আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পের সাথে পরিচিত হতে পারেন:

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

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

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"
    },
   …
  ]
}

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

নিয়ারবাই Search ব্যবহার করা

এই উদাহরণে, আপনি নিয়ারবাই 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 এবং রাউটিংয়ের উৎসের জন্য একই কোঅর্ডিনেট ব্যবহার করতে হবে না। যেমন, আপনি locationRestriction সিডনির কেন্দ্রবিন্দুতে সেট করেছেন যাতে সার্চ ফলাফল সেই বৃত্তের মধ্যে সীমাবদ্ধ থাকে। কিন্তু আপনি তারপর রাউটিংয়ের উৎস হিসেবে আপনার বাড়ির কোঅর্ডিনেট সেট করেছেন, অর্থাৎ সার্চ সার্কেলের মধ্যে অন্য একটি লোকেশন। অনুরোধটি তখন সার্চ ফলাফলকে বৃত্তের দিকে পক্ষপাতিত্ব করে এবং আপনার বাড়ির অবস্থানের উপর ভিত্তি করে রাউটিং সারাংশ গণনা করে।

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

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

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

• routingParameters.routingPreference প্রপার্টি ব্যবহার করে রাউটিং সংক্রান্ত পছন্দের বিকল্প TRAFFIC_UNAWARE (ডিফল্ট), TRAFFIC_AWARE বা TRAFFIC_AWARE_OPTIMAL হিসেবে সেট করুন। প্রতিটি বিকল্পে ডেটার কোয়ালিটি ও লেটেন্সির লেভেল আলাদা আলাদা হয়। আরও তথ্যের জন্য, ট্রাফিক ডেটা কীভাবে এবং অন্তর্ভুক্ত করা হবে কিনা তা নির্দিষ্ট করুন দেখুন।

  routingParameters.routingPreference প্রপার্টি প্রিভিউ (Pre-GA) directionsUri ফিল্ডে থাকা দিকনির্দেশকে প্রভাবিত করে কারণ Google Maps লিঙ্ক খোলার সময় ট্রাফিক সংক্রান্ত বিকল্প দেখায়।

• routingParameters.routeModifiers প্রপার্টি ব্যবহার করে avoidTolls, avoidHighways, avoidFerries ও avoidIndoor নির্দিষ্ট করুন। এইসব বিকল্পের ব্যাপারে আরও জানতে, এড়িয়ে যাওয়ার জন্য রুটের ফিচার নির্দিষ্ট করুন দেখুন।

পরবর্তী উদাহরণে, আপনি ভ্রমণের মোড হিসেবে 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'

এটি ব্যবহার করে দেখুন!

APIs Explorer আপনাকে স্যাম্পেল অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পের সাথে পরিচিত হতে পারেন।

1. পৃষ্ঠার ডানদিকে API আইকন api বেছে নিন।

2. ঐচ্ছিকভাবে, অনুরোধের প্যারামিটার এডিট করুন।

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

4. APIs Explorer প্যানেলে, APIs Explorer উইন্ডো বড় করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন বেছে নিন।