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

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

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

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

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

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

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

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

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

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

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

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

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

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

  • টোল পাসের মাধ্যমে রেট কম হতে পারে : কিছু অঞ্চলে, টোল পাসধারী ড্রাইভার বা যানবাহন যাদের পাস নেই তাদের তুলনায় আলাদা টোল প্রদান করে। উদাহরণস্বরূপ, যদি আপনার সিয়াটল, ওয়াশিংটন, মার্কিন যুক্তরাষ্ট্রে একটি Good To Go! টোল পাস থাকে, তাহলে আপনার পাস না থাকলে তার তুলনায় আপনাকে কম টোল প্রদান করতে হবে।

  • কিছু রাস্তার জন্য টোল পাসের প্রয়োজন হতে পারে : কিছু অঞ্চলে, যেমন ইন্দোনেশিয়ার, এমন রাস্তা আছে যেখানে টোল পাসের প্রয়োজন হয়। যদি আপনি এমন কোনও রুটের জন্য টোল পাস নির্দিষ্ট না করেন যেখানে টোল পাস প্রয়োজন, তাহলে 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'

টোল তথ্য সম্বলিত প্রতিক্রিয়া

উত্তরে TollInfo (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
            }
          ]
        }
      }
    }
  ]
}