هنگام محاسبه یک مسیر یا ماتریس مسیر، ممکن است بخواهید هرگونه هزینه عوارض در مسیر را در نظر بگیرید. برای شهرهای منتخب، می‌توانید هزینه عوارض تخمینی برای یک مسیر را با واحد پول مناسب محاسبه کنید.
برای دریافت عوارض برای ماتریس مسیر، به محاسبه هزینه‌های عوارض برای ماتریس مسیر مراجعه کنید.
برای فهرست مکان‌های دارای عوارض پشتیبانی‌شده، به مرجع TollPass مراجعه کنید.
نحوه محاسبه عوارض
API مسیرها، هزینه تخمینی عوارض را با در نظر گرفتن هرگونه تخفیف یا مجوز عوارض موجود برای راننده یا وسیله نقلیه و راحت‌ترین روش‌های پرداخت محاسبه می‌کند. اگر برای یک مسیر مشخص، قیمت عوارض در دسترس نباشد، API مسیرها وجود عوارضی با هزینه نامشخص را نشان می‌دهد.
برای دریافت برآورد دقیق عوارض، مطمئن شوید که اطلاعات زیر را در درخواست خود ذکر می‌کنید:
- نوع انتشار گازهای گلخانه‌ای وسیله نقلیه مورد استفاده برای مسیر (
VehicleEmissionType). اگر نوع انتشار گازهای گلخانه‌ای ارائه نشود، عوارض مربوط به وسیله نقلیه بنزینی بازگردانده می‌شود. - تمام عوارضی که وسیله نقلیه و راننده از آن استفاده می‌کنند (
TollPass). این API از عوارضی‌ها برای تعیین هزینه‌های دقیق عوارض استفاده می‌کند و در صورتی که عوارضی‌های ذکر شده در درخواست، محلی برای مسیر نباشند، قیمت‌های نقدی را برمی‌گرداند. - در صورت نیاز، اجتناب از عوارض را مشخص کنید . اگر می‌خواهید در صورت امکان از جاده‌های دارای عوارض اجتناب کنید،
avoidTollsبه عنوانRouteModifierاضافه کنید.
محاسبه عوارض با استفاده از کارت عوارضی
برای محاسبه عوارض با استفاده از یک گذرگاه عوارضی، شما هرگونه گذرگاه عوارضی را به عنوان بخشی از درخواست مشخص می‌کنید. سپس 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 } ] } } } ] }