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

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

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

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