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

מפתחים באזור הכלכלי האירופי (EEA)

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

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

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