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

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

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

רשימת מיקומי האגרות הנתמכים מופיעה במאמר העזרה בנושא TollPass.

דוגמה למטריצה של מסלולים עם חיובים

בדוגמה הבאה נעשה שימוש בשיטה computeRouteMatrix כדי להציג מידע על כבישי אגרה במסלול, כולל מחיר משוער לשימוש בכרטיס נסיעה:

  • כדי לאפשר את החישוב של פרטי החיובים, מגדירים את השדה של המערך extraComputations לערך TOLLS.

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

  • משתמשים במסכת שדה התגובה כדי להגדיר את השיטה להחזרת פרטי התשלום בדרך. מציינים את הערך 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
           }
        ]
      }
    }
  }
]