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

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

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

לרשימת המיקומים שבהם כבישי אגרה נתמכים, ראו TollPass.

זהירות: בקשות שמחשבות את עמלות האגרה מחויבות בתעריף גבוה יותר. מידע נוסף על החיוב ב-Routs API

דוגמה לכבישי אגרה מסוג 'מסלול'

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

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

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

• משתמשים באנונימיזציה של שדות התשובה כדי להגדיר את השיטה להחזרת פרטי האגרה בתשובה. מציינים את הערך routes.travelAdvisory.tollInfo כדי להחזיר מידע על כל המסלול.

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

בקשה לקבלת מידע על מטריצת מסלולים

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
           }
        ]
      }
    }
  }
]