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

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

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

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