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

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

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

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

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

‫Routes API מחשב את אגרת הנסיעה המשוערת, תוך התחשבות בהנחות או בכרטיסי מעבר בכבישי אגרה שזמינים לנהג או לרכב, ובאמצעי התשלום הנוחים ביותר. אם אין מחיר אגרה זמין למסלול מסוים, Routes 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
            }
          ]
        }
      }
    }
  ]
}