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

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

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

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

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

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

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

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

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

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

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

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

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

  • টোল পাসের সাথে রেট কম হতে পারে : কিছু অঞ্চলে, টোল পাস সহ একজন চালক বা গাড়ি যাদের কাছে পাস নেই তাদের চেয়ে আলাদা টোল প্রদান করে। উদাহরণস্বরূপ, যদি আপনি একটি ভাল যান! সিয়াটল, 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) অবজেক্টে টোলের তথ্য রয়েছে। এই উদাহরণে, আপনি পুরো রুটের জন্য এবং রুটের প্রতিটি পায়ের জন্য টোল তথ্য ফেরত দেন।

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