חישוב עמלות אגרה

מפתחים באזור הכלכלי האירופי (EEA)

כשמחשבים מסלול או מטריצת מסלולים, כדאי לקחת בחשבון את האגרה שצריך לשלם על המסלול. בערים נבחרות, אפשר לחשב את סכום האגרה המשוער למסלול במטבע המתאים.

רשימת המיקומים שבהם נתמך תשלום אגרה מופיעה במאמר בנושא TollPass.

איך מחושבים אגרות המעבר

‫Routes API מחשב את סכום האגרה המשוער, תוך התחשבות בהנחות או בכרטיסי מעבר שזמינים לנהג או לרכב, ובאמצעי התשלום הנוחים ביותר. אם אין מחיר אגרה זמין למסלול מסוים, Routes API מציין את קיומה של אגרה עם עמלה לא ידועה.

כדי לקבל הערכות מדויקות של תעריפי אגרה, חשוב לכלול בבקשה את הפרטים הבאים:

  • סוג הפליטה של הרכב שבו משתמשים במסלול (VehicleEmissionType). אם לא מצוין סוג פליטה, מוחזר סכום האגרה לרכב שמונע על ידי בנזין.
  • כל כרטיסי המעבר בכבישי אגרה שיש לרכב ולנהג באמצעות tollPasses. ה-API משתמש בכרטיסי התשלום כדי לקבוע את דמי האגרה המדויקים, ומחזיר מחירים במזומן אם כרטיסי התשלום שצוינו בבקשה לא רלוונטיים למסלול.
  • מציינים אם רוצים להימנע מכבישי אגרה. אם אתם רוצים להימנע מכבישי אגרה ככל האפשר, אתם יכולים להוסיף את 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'],
};