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