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

מפתחים באזור הכלכלי האירופי (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
           }
        ]
      }
    }
  }
]