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

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

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

רשימת המיקומים הנתמכים לתשלום אגרה מופיעה במאמר בנושא 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
            }
          ]
        }
      }
    }
  ]
}