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

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

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

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