כשמחשבים מטריצת מסלולים, כדאי להביא בחשבון את עמלות האגרה במסלולים במטריצה. בערים נבחרות אפשר לחשב את עמלת האגרה המשוערת למסלול במטבע המתאים.
למידע על כבישי אגרה, קראו את המאמר חישוב עמלות האגרה למסלול.
בחומר העזר של TollPass תוכלו למצוא רשימה של מיקומי כבישי האגרה הנתמכים.
דוגמה לכבישי אגרה עם מטריצת מסלולים
בדוגמה הבאה נעשה שימוש בשיטה computeRouteMatrix
כדי להחזיר מידע על כבישי אגרה עם מחיר משוער כשמשתמשים בכרטיס אגרה:
כדי לאפשר את החישוב של פרטי האגרה, מגדירים את השדה 'מערך'
extraComputations
לערךTOLLS
.מציינים את סוג הרכב ואת הסוג של מינוי האגרה באמצעות השדה
routeModifiers
בנקודות הציון המקור של הבקשה. מחיר האגרה שמוחזר מבוסס על המחיר של סוג הרכב וכרטיס הנסיעה שצוינו. אם מציינים יותר מכרטיס אחד, מוחזר המחיר הזול ביותר.משתמשים במסכת השדות של התגובה כדי להגדיר את ה-method להחזרת פרטי האגרה בתשובה. מציינים
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).
כדי להגדיר את ה-method להחזרת פרטי האגרה, משתמשים במסכת השדות של התגובה כדי להגדיר את השדה travelAdvisory.tollInfo
במסכה.
[ { "originIndex": 0, "destinationIndex": 0, "status": {}, "distanceMeters": 150338, "duration": "5382s", "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ]