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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • خصوصیت extraComputations را روی TOLLS تنظیم کنید.
  • نوع خودرو و نوع گذرکارت عوارضی را بااستفاده از ویژگی routeModifiers مشخص کنید.
  • برای محاسبه هزینه عوارض برای کل مسیر، travelAdvisory را در ویژگی fields درخواست کنید؛ اطلاعات عوارض کل مسیر را با خواندن route.travelAdvisory.tollInfo مشاهده کنید.
  • برای محاسبه هزینه عوارض برای بخش‌های تکی مسیر، legs را در ویژگی fields درخواست کنید؛ اطلاعات عوارض هر بخش را با خواندن 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'],
};