একটি রুটের জন্য টোল ফি গণনা করুন

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

একটি রুট ম্যাট্রিক্সের জন্য টোল পেতে, একটি রুট ম্যাট্রিক্সের জন্য টোল ফি গণনা করুন দেখুন।

সমর্থিত টোল অবস্থানের তালিকার জন্য, টোলপাসের রেফারেন্স দেখুন।

সতর্কতা: টোল ফি গণনা করার অনুরোধগুলি উচ্চ হারে বিল করা হয়। রুট API-এর জন্য বিলিং সম্পর্কে আরও জানুন ।

কিভাবে টোল গণনা করা হয়

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

দ্রষ্টব্য : Routes API Google Maps থেকে ভিন্নভাবে একটি রুটে টোল গণনা করে:

• Routes API শুধুমাত্র টোল মূল্য (পাস বা নগদ) ফেরত দেয় যা আসলে ট্রিপের জন্য চার্জ করা হবে, ধরে নিলাম যে আপনার অনুরোধটি প্রতিটি ড্রাইভার এবং/অথবা গাড়ির কী ধরনের পাস রয়েছে তা সঠিকভাবে উপস্থাপন করে। আপনি যদি কোনো টোল পাস নির্দিষ্ট না করেন, তাহলে API নগদ মূল্য ফেরত দেয়, যা সাধারণত সর্বোচ্চ টোল।
• Google Maps সাধারণত একটি গাড়ির জন্য সবচেয়ে সস্তা সম্ভাব্য মূল্য ফেরত দেয়। ব্যবহারকারীরা তাদের কোন টোল পাস আছে তা নির্দিষ্ট করতে পারে না; পরিবর্তে, নগদ টোল দেখতে, ব্যবহারকারীরা টোল পাস মূল্য দেখুন বিকল্পটি নিষ্ক্রিয় করতে পারেন, যা ডিফল্টরূপে সক্রিয় থাকে।

সঠিক টোল অনুমান পেতে, নিশ্চিত করুন যে আপনি আপনার অনুরোধে নিম্নলিখিত তথ্য অন্তর্ভুক্ত করেছেন:

• রুটের জন্য ব্যবহৃত গাড়ির নির্গমনের ধরন ( VehicleEmissionType )। যদি কোনো নির্গমনের ধরন প্রদান করা না হয়, তাহলে পেট্রল-জ্বালানিযুক্ত গাড়ির জন্য টোল ফেরত দেওয়া হয়।
• সমস্ত টোল পাস যানবাহন এবং চালক ব্যবহার করেছেন ( TollPass )। এপিআই সঠিক টোল ফি নির্ধারণ করতে টোল পাস ব্যবহার করে এবং অনুরোধে টোল পাস রুটের স্থানীয় না হলে নগদ মূল্য ফেরত দেয়।
• প্রয়োজনে টোল এড়ানো নির্দিষ্ট করুন । আপনি যদি সম্ভব হলে টোল রাস্তাগুলি এড়াতে চান, avoidTolls যোগ করুন একটি RouteModifier হিসাবে।

একটি টোল পাস ব্যবহার করে টোল গণনা করুন

একটি টোল পাস ব্যবহার করে টোল গণনা করতে, আপনি অনুরোধের অংশ হিসাবে যে কোনও টোল পাস নির্দিষ্ট করুন৷ API তারপর পাস মূল্য প্রদান করে।

• আপনি যদি একটি অবৈধ টোল পাস নির্দিষ্ট করেন, পাসটি উপেক্ষা করা হয়।

• একটি অ্যারে হিসাবে একাধিক টোল পাস নির্দিষ্ট করলে, API প্রতিটি পাসের জন্য রুটের মূল্য গণনা করার চেষ্টা করে।

দ্রষ্টব্য: আপনি শুধুমাত্র DRIVE এবং TWO_WHEELER ভ্রমণ মোডের জন্য একটি টোল পাস নির্দিষ্ট করতে পারেন৷

টোল পাসের আচরণ অঞ্চল অনুসারে পরিবর্তিত হতে পারে।

• টোল পাসের সাথে রেট কম হতে পারে : কিছু অঞ্চলে, টোল পাস সহ একজন চালক বা গাড়ি যাদের কাছে পাস নেই তাদের চেয়ে আলাদা টোল প্রদান করে। উদাহরণস্বরূপ, যদি আপনি একটি ভাল যান! সিয়াটল, WA, US-এ টোল পাস, যদি আপনার কাছে পাস না থাকে তবে আপনি তার চেয়ে কম টোল প্রদান করবেন।

• কিছু রাস্তার জন্য টোল পাসের প্রয়োজন হতে পারে : কিছু অঞ্চলে, যেমন ইন্দোনেশিয়া, এমন রাস্তা আছে যেগুলির জন্য টোল পাস প্রয়োজন৷ আপনি যদি এমন একটি রুটের জন্য একটি টোল পাস নির্দিষ্ট না করেন যেখানে একটি টোল পাসের প্রয়োজন হয়, তাহলে API একটি টোল মূল্য ফেরত দেয় না।

একটি রুটের জন্য টোল ফি গণনা করুন

নিম্নোক্ত উদাহরণটি টোল পাস ব্যবহার করার সময় আনুমানিক মূল্য সহ টোল তথ্য ফেরত দিতে computeRoutes পদ্ধতি ব্যবহার করে। এই উদাহরণে, আপনি:

• টোল তথ্যের গণনা সক্ষম করতে extraComputations অ্যারে ক্ষেত্রটি TOLLS এ সেট করুন।

• অনুরোধের routeModifiers ক্ষেত্র ব্যবহার করে গাড়ির ধরন এবং টোল পাসের ধরন নির্দিষ্ট করুন। ফেরত দেওয়া টোল মূল্য নির্দিষ্ট গাড়ির ধরন এবং পাস দ্বারা ব্যবহৃত মূল্যের উপর ভিত্তি করে। একাধিক পাস নির্দিষ্ট করা হলে, সর্বনিম্ন ব্যয়বহুল মূল্য ফেরত দেওয়া হয়।

• প্রতিক্রিয়ায় টোল তথ্য ফেরত দেওয়ার পদ্ধতিটি কনফিগার করতে প্রতিক্রিয়া ক্ষেত্র মাস্ক ব্যবহার করুন। এই উদাহরণে, অনুরোধটি প্রতিক্রিয়া ক্ষেত্রের মাস্কে নিম্নলিখিত বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করেছে:

  • routes.travelAdvisory.tollInfo ফিল্ড পুরো রুটের তথ্য ফেরত দিতে।

  • প্রতিটি পায়ের তথ্য ফেরত দিতে routes.legs.travelAdvisory.tollInfo ।

  দ্রষ্টব্য: এই রুটে শুধুমাত্র একটি পা রয়েছে।

টোল তথ্যের জন্য অনুরোধ

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "extraComputations": ["TOLLS"],
  "routeModifiers":{
    "vehicleInfo":{
      "emissionType": "GASOLINE"
    },
    "tollPasses": [
      "US_MA_EZPASSMA",
      "US_WA_GOOD_TO_GO"
    ]
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

টোল তথ্য ধারণকারী প্রতিক্রিয়া

প্রতিক্রিয়াটিতে একটি টোলইনফো (REST) ​​বা TollInfo (gRPC) অবজেক্টে টোলের তথ্য রয়েছে। এই উদাহরণে, আপনি পুরো রুটের জন্য এবং রুটের প্রতিটি পায়ের জন্য টোল তথ্য ফেরত দেন।

দ্রষ্টব্য : রুট এপিআই একটি estimatedPrice প্রদান করে যা অ-বাণিজ্যিক যানবাহনের ক্ষেত্রে প্রযোজ্য।

• বাণিজ্যিক যানবাহনের জন্য টোলের দাম ভিন্ন হতে পারে।
• units এবং nanos বাদ দেওয়া হয় যখন তাদের মান শূন্য হয়।

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}