যখন আপনি কোনো রুট বা রুট ম্যাট্রিক্স গণনা করছেন, তখন আপনি সেই রুটের যেকোনো টোল ফি বিবেচনা করতে চাইতে পারেন। নির্দিষ্ট কিছু শহরের জন্য, আপনি উপযুক্ত মুদ্রায় একটি রুটের আনুমানিক টোল ফি গণনা করতে পারেন।
একটি রুট ম্যাট্রিক্সের জন্য টোল পেতে, "একটি রুট ম্যাট্রিক্সের জন্য টোল ফি গণনা করুন" দেখুন।
সমর্থিত টোল স্থানগুলির তালিকার জন্য, টোলপাস- এর রেফারেন্স দেখুন।
টোল কীভাবে গণনা করা হয়
রুটস এপিআই চালক বা যানবাহনের জন্য উপলব্ধ যেকোনো টোল মূল্যের ছাড় বা পাস এবং সবচেয়ে সুবিধাজনক অর্থপ্রদানের পদ্ধতিগুলো বিবেচনা করে আনুমানিক টোল ফি গণনা করে। যদি কোনো নির্দিষ্ট রুটের জন্য কোনো টোল মূল্য উপলব্ধ না থাকে, তবে রুটস এপিআই একটি অজানা ফি-যুক্ত টোলের অস্তিত্ব নির্দেশ করে।
টোলের সঠিক হিসাব পেতে, আপনার অনুরোধে নিম্নলিখিত তথ্যগুলো অবশ্যই অন্তর্ভুক্ত করুন:
- রুটে ব্যবহৃত যানবাহনের নির্গমনের ধরণ (
VehicleEmissionType)। যদি নির্গমনের ধরণ উল্লেখ না করা হয়, তবে পেট্রোল চালিত যানবাহনের টোল ফেরত দেওয়া হয়। - যানবাহন এবং চালকের কাছে থাকা সমস্ত টোল পাস (
TollPass) ব্যবহার করে দেখানো হয়। এপিআইটি সঠিক টোল ফি নির্ধারণ করতে টোল পাসগুলি ব্যবহার করে এবং অনুরোধে থাকা টোল পাসগুলি রুটের জন্য স্থানীয় না হলে নগদ মূল্য ফেরত দেয়। - প্রয়োজনে টোল এড়িয়ে চলার নির্দেশ দিন । যদি আপনি যথাসম্ভব টোল রোড এড়াতে চান, তাহলে
RouteModifierহিসেবেavoidTollsযোগ করুন।
টোল পাস ব্যবহার করে টোল গণনা করুন
টোল পাস ব্যবহার করে টোল গণনা করতে, আপনাকে অনুরোধের অংশ হিসেবে যেকোনো টোল পাস উল্লেখ করতে হবে। এরপর এপিআই পাসের মূল্য ফেরত দেবে।
আপনি যদি একটি অবৈধ টোল পাস প্রদান করেন, তবে পাসটি উপেক্ষা করা হবে।
যদি একাধিক টোল পাস একটি অ্যারে হিসাবে নির্দিষ্ট করা হয়, তাহলে এপিআই প্রতিটি পাসের জন্য রুটটির মূল্য গণনা করার চেষ্টা করে।
টোল পাসের কার্যকারিতা অঞ্চলভেদে ভিন্ন হতে পারে।
টোল পাস থাকলে টোলের হার কম হতে পারে : কিছু অঞ্চলে, টোল পাসধারী চালক বা যানবাহনকে পাসবিহীনদের চেয়ে ভিন্ন হারে টোল দিতে হয়। উদাহরণস্বরূপ, মার্কিন যুক্তরাষ্ট্রের ওয়াশিংটন অঙ্গরাজ্যের সিয়াটলে যদি আপনার একটি ‘গুড টু গো! ’ টোল পাস থাকে, তবে পাস না থাকার চেয়ে আপনাকে কম টোল দিতে হবে।
কিছু রাস্তায় টোল পাসের প্রয়োজন হতে পারে : ইন্দোনেশিয়ার মতো কিছু অঞ্চলে এমন রাস্তা রয়েছে যেখানে টোল পাসের প্রয়োজন হয়। যদি আপনি এমন কোনো রুটের জন্য টোল পাস নির্দিষ্ট না করেন যেখানে টোল পাসের প্রয়োজন, তাহলে 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 } ] } } } ] }