বিকল্প রুট অনুরোধ

ডিফল্টরূপে, Routes API ডিফল্ট রুট ফেরত দেয়, যা সাধারণত মূল থেকে গন্তব্যে যাওয়ার দ্রুততম রুট। আপনি যখন বিকল্প রুটের অনুরোধ করেন, তখন API ডিফল্ট রুটের সাথে তিনটি রুট পর্যন্ত ফেরত দেয়। তারপরে আপনার গ্রাহকরা তাদের প্রয়োজনীয়তার সাথে সবচেয়ে উপযুক্ত একটি রুট বেছে নিতে পারেন।

বিকল্প রুট অনুরোধ করার সময় বিবেচনা

বিকল্প রুটের অনুরোধ করতে, নিম্নলিখিত বিবেচনার বিষয়ে সচেতন থাকুন:

• আপনি মধ্যবর্তী ওয়েপয়েন্ট ছাড়া রুটের জন্য শুধুমাত্র বিকল্প রুটের অনুরোধ করতে পারেন। যখন রুট মধ্যবর্তী ওয়েপয়েন্ট নির্দিষ্ট করে তখন বিকল্প রুটের অনুরোধ করা কোনো ত্রুটির কারণ হয় না। তবে বিকল্প কোনো রুটে ফেরত আসছে না।

• প্রতিক্রিয়া সর্বাধিক তিনটি বিকল্প রুট রয়েছে. যাইহোক, কখনও কখনও কোন বিকল্প রুট পাওয়া যায় না তাই প্রতিক্রিয়া শুধুমাত্র ডিফল্ট রুট ধারণ করে।

• বিকল্প রুট গণনা করার জন্য প্রয়োজনীয় অতিরিক্ত প্রক্রিয়াকরণের কারণে, বিকল্প রুটের অনুরোধ করা API-এর প্রতিক্রিয়া সময় বাড়িয়ে দিতে পারে।

বিকল্প রুট অনুরোধের উদাহরণ

বিকল্প রুট অনুরোধ করতে computeAlternativeRoutes true সেট করুন। নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি computeRoutes পদ্ধতি (REST) ​​অনুরোধে বিকল্প রুট অনুরোধ করতে হয়।

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "computeAlternativeRoutes": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

এই উদাহরণে, আপনি একটি ফিল্ড মাস্ক নির্দিষ্ট করুন যাতে প্রতিক্রিয়াটিতে প্রতিটি রুটের জন্য শুধুমাত্র duration , distanceMeters, এবং routeLabels বৈশিষ্ট্য থাকে। আপনার গ্রাহক তখন সেই তথ্য ব্যবহার করে কোন পথ বেছে নিতে পারেন। আরও তথ্যের জন্য, কোন তথ্য ফেরত দিতে হবে তা বেছে নিন দেখুন।

উদাহরণ বিকল্প রুট প্রতিক্রিয়া

প্রতিক্রিয়ায়, পৌঁছানোর রুট সনাক্ত করতে routeLabels অ্যারে সম্পত্তি ব্যবহার করুন:

• ডিফল্ট রুটের জন্য, routeLabels বৈশিষ্ট্যে DEFAULT_ROUTE রয়েছে।

• যেকোনো বিকল্প রুটের জন্য, routeLabels বৈশিষ্ট্যে DEFAULT_ROUTE_ALTERNATE থাকে।

এই উদাহরণে, প্রতিক্রিয়াতে ডিফল্ট রুট এবং দুটি বিকল্প রুট রয়েছে। লক্ষ্য করুন যে duration এবং distanceMeters বৈশিষ্ট্যের মান প্রতিটি রুটের জন্য আলাদা:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}

প্রতিক্রিয়াতে পলিলাইনগুলি অন্তর্ভুক্ত করুন

ব্যবহারকারীর জন্য রুট নির্বাচন করা সহজ করতে, প্রতিক্রিয়াতে প্রতিটি রুটের জন্য পলিলাইন যোগ করুন। তারপরে আপনি একটি মানচিত্রে প্রতিটি পলিলাইন প্রদর্শন করতে পারেন।

পলিলাইন যোগ করতে, ফিল্ড মাস্কে routes.polyline অন্তর্ভুক্ত করুন:

-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'

প্রতিক্রিয়া তারপর প্রতিটি রুটের জন্য পলিলাইন ধারণ করে:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "polyline": {
        "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "polyline": {
        "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "polyline": {
        "encodedPolyline": "FVLL|Af@HPAV…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}

ডিফল্টরূপে, Routes API ডিফল্ট রুট ফেরত দেয়, যা সাধারণত মূল থেকে গন্তব্যে যাওয়ার দ্রুততম রুট। আপনি যখন বিকল্প রুটের অনুরোধ করেন, তখন API ডিফল্ট রুটের সাথে তিনটি রুট পর্যন্ত ফেরত দেয়। তারপরে আপনার গ্রাহকরা তাদের প্রয়োজনীয়তার সাথে সবচেয়ে উপযুক্ত একটি রুট বেছে নিতে পারেন।

বিকল্প রুট অনুরোধ করার সময় বিবেচনা

বিকল্প রুটের অনুরোধ করতে, নিম্নলিখিত বিবেচনার বিষয়ে সচেতন থাকুন:

• আপনি মধ্যবর্তী ওয়েপয়েন্ট ছাড়া রুটের জন্য শুধুমাত্র বিকল্প রুটের অনুরোধ করতে পারেন। যখন রুট মধ্যবর্তী ওয়েপয়েন্ট নির্দিষ্ট করে তখন বিকল্প রুটের অনুরোধ করা কোনো ত্রুটির কারণ হয় না। তবে বিকল্প কোনো রুটে ফেরত আসছে না।

• প্রতিক্রিয়া সর্বাধিক তিনটি বিকল্প রুট রয়েছে. যাইহোক, কখনও কখনও কোন বিকল্প রুট পাওয়া যায় না তাই প্রতিক্রিয়া শুধুমাত্র ডিফল্ট রুট ধারণ করে।

• বিকল্প রুট গণনা করার জন্য প্রয়োজনীয় অতিরিক্ত প্রক্রিয়াকরণের কারণে, বিকল্প রুটের অনুরোধ করা API-এর প্রতিক্রিয়া সময় বাড়িয়ে দিতে পারে।

বিকল্প রুট অনুরোধের উদাহরণ

বিকল্প রুট অনুরোধ করতে computeAlternativeRoutes true সেট করুন। নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি computeRoutes পদ্ধতি (REST) ​​অনুরোধে বিকল্প রুট অনুরোধ করতে হয়।

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "computeAlternativeRoutes": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

এই উদাহরণে, আপনি একটি ফিল্ড মাস্ক নির্দিষ্ট করুন যাতে প্রতিক্রিয়াটিতে প্রতিটি রুটের জন্য শুধুমাত্র duration , distanceMeters, এবং routeLabels বৈশিষ্ট্য থাকে। আপনার গ্রাহক তখন সেই তথ্য ব্যবহার করে কোন পথ বেছে নিতে পারেন। আরও তথ্যের জন্য, কোন তথ্য ফেরত দিতে হবে তা বেছে নিন দেখুন।

উদাহরণ বিকল্প রুট প্রতিক্রিয়া

প্রতিক্রিয়ায়, পৌঁছানোর রুট সনাক্ত করতে routeLabels অ্যারে সম্পত্তি ব্যবহার করুন:

• ডিফল্ট রুটের জন্য, routeLabels বৈশিষ্ট্যে DEFAULT_ROUTE রয়েছে।

• যেকোনো বিকল্প রুটের জন্য, routeLabels বৈশিষ্ট্যে DEFAULT_ROUTE_ALTERNATE থাকে।

এই উদাহরণে, প্রতিক্রিয়াতে ডিফল্ট রুট এবং দুটি বিকল্প রুট রয়েছে। লক্ষ্য করুন যে duration এবং distanceMeters বৈশিষ্ট্যের মান প্রতিটি রুটের জন্য আলাদা:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}

প্রতিক্রিয়াতে পলিলাইনগুলি অন্তর্ভুক্ত করুন

ব্যবহারকারীর জন্য রুট নির্বাচন করা সহজ করতে, প্রতিক্রিয়াতে প্রতিটি রুটের জন্য পলিলাইন যোগ করুন। তারপরে আপনি একটি মানচিত্রে প্রতিটি পলিলাইন প্রদর্শন করতে পারেন।

পলিলাইন যোগ করতে, ফিল্ড মাস্কে routes.polyline অন্তর্ভুক্ত করুন:

-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'

প্রতিক্রিয়া তারপর প্রতিটি রুটের জন্য পলিলাইন ধারণ করে:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "polyline": {
        "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "polyline": {
        "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "polyline": {
        "encodedPolyline": "FVLL|Af@HPAV…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}