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

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

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

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