כשמחשבים מטריצת מסלולים, יכול להיות שתרצו להביא בחשבון את כל עמלות האגרה במסלולים שבמטריצה. בערים נבחרות, אפשר לחשב את אגרת הנסיעה המשוערת במסלול במטבע המתאים.
כדי לקבל את מחירי האגרות במסלול, קראו את המאמר חישוב מחירי האגרות במסלול.
רשימת המיקומים הנתמכים של כבישי אגרה מופיעה במאמר העזרה בנושא TollPass.
דוגמה לאגרת מטריצת מסלולים
בדוגמה הבאה, השיטה computeRouteMatrix מחזירה מידע על כבישי אגרה במסלול עם מחיר משוער כשמשתמשים במינוי לכביש אגרה:
כדי להפעיל את חישוב המידע על אגרות, מגדירים את השדה של המערך
extraComputationsלערךTOLLS.מציינים את סוג כלי הרכב ואת סוג המינוי לכביש אגרה באמצעות השדה
routeModifiersשל נקודות הציון של המוצא בבקשה. מחיר האגרה שמוחזר מבוסס על התמחור שמשמש את סוג כלי הרכב והמינוי שצוינו. אם מציינים יותר מכרטיס אחד, הפונקציה מחזירה את המחיר הזול ביותר.משתמשים במסכת שדה התגובה כדי להגדיר את השיטה להחזרת מידע על אגרות בתגובה. מציינים את הערך
routes.travelAdvisory.tollInfoכדי לקבל מידע על כל המסלול.
בקשה לקבלת מידע על אגרות במטריצת מסלולים
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude":42.340173523716736, "longitude":-71.05997968330408 } } }, "routeModifiers": { "vehicleInfo":{ "emissionType": "GASOLINE" }, "tollPasses": [ "US_MA_EZPASSMA", "US_WA_GOOD_TO_GO" ] } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude":42.075698891472804, "longitude": -72.59806562080408 } } } } ], "travelMode": "DRIVE", "extraComputations": ["TOLLS"] }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
תגובה למידע על אגרות במטריצת מסלולים
התשובה מכילה מידע על כבישי אגרה באובייקט TollInfo (REST) או TollInfo (gRPC).
כדי להגדיר את השיטה להחזרת מידע על כבישי אגרה, משתמשים במסכת שדה התגובה כדי להגדיר את השדה travelAdvisory.tollInfo במסכה.
[ { "originIndex": 0, "destinationIndex": 0, "status": {}, "distanceMeters": 150338, "duration": "5382s", "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ]