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

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

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

এই উদাহরণ থেকে, আপনি দেখতে পাচ্ছেন যে রাউটিং উৎপত্তিস্থল থেকে ফলাফলের প্রথম স্থান পর্যন্ত সময়কাল এবং দূরত্ব 597 সেকেন্ড এবং 2607 মিটার।

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

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

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

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

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

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

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

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

• routingParameters.routeModifiers প্রোপার্টি ব্যবহার করে avoidTolls , avoidHighways , avoidFerries এবং avoidIndoor উল্লেখ করুন। এই বিকল্পগুলি সম্পর্কে আরও তথ্যের জন্য, avoid করার জন্য রুট বৈশিষ্ট্যগুলি নির্দিষ্ট করুন দেখুন।

পরবর্তী উদাহরণে, আপনি হাইওয়ে এড়াতে এবং 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 উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন নির্বাচন করুন।