חישוב עמלות מטריצת מסלולים

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

כדי לקבל כבישי אגרה במסלול מסוים: חישוב עמלות האגרה למסלול.

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

דוגמה לכבישי אגרה עם מטריצת מסלולים

הדוגמה הבאה משתמשת computeRouteMatrix שיטה להחזרת מידע על כבישי אגרה במסלול עם עלות משוערת המחיר כשמשתמשים בכרטיס אגרה:

• כדי להפעיל את החישוב, צריך להגדיר את השדה 'מערך' של extraComputations לערך TOLLS של כבישי אגרה.

• מציינים את סוג הרכב ואת הסוג של מינוי האגרה באמצעות השדה routeModifiers בנקודות הציון של ה-origin של הבקשה. האגרה המחיר שמוחזר מבוסס על המחיר שבו נעשה שימוש בסוג הרכב שצוין ולעבור. אם מציינים יותר מכרטיס אחד, המחיר הזול ביותר הוא הוחזרו.

• משתמשים במסכת שדות של תשובה כדי להגדיר את השיטה שיחזיר את פרטי האגרה בתשובה. יש לפרט 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
           }
        ]
      }
    }
  }
]