هزینه عوارض را محاسبه کنید

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

هنگام محاسبه یک مسیر یا ماتریس مسیر، ممکن است بخواهید هرگونه هزینه عوارض در مسیر را در نظر بگیرید. برای شهرهای منتخب، می‌توانید هزینه عوارض تخمینی برای یک مسیر را با واحد پول مناسب محاسبه کنید.

برای فهرست مکان‌های دارای عوارض پشتیبانی‌شده، به مرجع TollPass مراجعه کنید.

نحوه محاسبه عوارض

API مسیرها، هزینه تخمینی عوارض را با در نظر گرفتن هرگونه تخفیف یا مجوز عوارض موجود برای راننده یا وسیله نقلیه و راحت‌ترین روش‌های پرداخت محاسبه می‌کند. اگر برای یک مسیر مشخص، قیمت عوارض در دسترس نباشد، API مسیرها وجود عوارضی با هزینه نامشخص را نشان می‌دهد.

برای دریافت برآورد دقیق عوارض، مطمئن شوید که اطلاعات زیر را در درخواست خود ذکر می‌کنید:

  • نوع انتشار گازهای گلخانه‌ای وسیله نقلیه مورد استفاده برای مسیر ( VehicleEmissionType ). اگر نوع انتشار گازهای گلخانه‌ای ارائه نشود، عوارض مربوط به وسیله نقلیه بنزینی بازگردانده می‌شود.
  • تمام عوارضی که وسیله نقلیه و راننده از طریق tollPasses دریافت می‌کنند. API از عوارضی‌ها برای تعیین هزینه‌های دقیق عوارض استفاده می‌کند و در صورتی که عوارضی‌های ذکر شده در درخواست، محلی نباشند، قیمت‌های نقدی را برمی‌گرداند.
  • در صورت نیاز، اجتناب از عوارض را مشخص کنید . اگر می‌خواهید در صورت امکان از جاده‌های دارای عوارض اجتناب کنید، avoidTolls به عنوان RouteModifier اضافه کنید.

محاسبه عوارض با استفاده از کارت عوارضی

برای محاسبه عوارض با استفاده از یک گذرگاه عوارضی، شما هرگونه گذرگاه عوارضی را به عنوان بخشی از درخواست مشخص می‌کنید. سپس API قیمت‌های گذرگاه را برمی‌گرداند.

  • اگر یک مجوز عوارض نامعتبر مشخص کنید، مجوز نادیده گرفته می‌شود.
  • اگر چندین گذرگاه عوارضی را به صورت آرایه مشخص کنید، API تلاش می‌کند تا قیمت مسیر را برای هر گذرگاه محاسبه کند.

نحوه‌ی رفتار عوارضی می‌تواند بر اساس منطقه متفاوت باشد.

  • ممکن است نرخ‌ها با کارت عوارض کمتر باشد : در برخی مناطق، راننده یا وسیله نقلیه‌ای که کارت عوارض دارد، عوارض متفاوتی نسبت به کسانی که کارت ندارند، پرداخت می‌کند. به عنوان مثال، اگر در سیاتل، واشنگتن، ایالات متحده، کارت عوارض Good To Go! داشته باشید، عوارض کمتری نسبت به زمانی که کارت عوارض ندارید، پرداخت می‌کنید.
  • ممکن است برخی از جاده‌ها به عوارض نیاز داشته باشند : برخی مناطق، مانند اندونزی، جاده‌هایی دارند که به عوارض نیاز دارند. اگر برای مسیری که عوارض لازم دارد، عوارض تعیین نکنید، API قیمت عوارض را برنمی‌گرداند.

محاسبه عوارض یک مسیر

برای محاسبه هزینه عوارض برای یک مسیر، مراحل زیر را انجام دهید:

  • ویژگی extraComputations را روی TOLLS تنظیم کنید.
  • با استفاده از ویژگی routeModifiers نوع وسیله نقلیه و نوع گذرگاه عوارضی را مشخص کنید.
  • برای محاسبه‌ی هزینه‌های عوارض برای کل مسیر، در خاصیت fields درخواست travelAdvisory درخواست کنید؛ اطلاعات عوارض کل مسیر را با خواندن route.travelAdvisory.tollInfo مشاهده کنید.
  • برای محاسبه‌ی هزینه‌های عوارض برای بخش‌های مختلف یک مسیر، در ویژگی fields درخواست legs درخواست کنید؛ اطلاعات عوارض هر بخش را با خواندن route.legs[i].travelAdvisory.tollInfo مشاهده کنید.

مثال

مثال درخواست زیر نحوه درخواست هزینه عوارض برای یک مسیر را نشان می‌دهد:

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};