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

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

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

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

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

דוגמה לכבישי אגרה עם מטריצת מסלולים

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

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

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

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

כדי להגדיר את ה-method להחזרת פרטי האגרה, משתמשים במסכת השדות של התגובה כדי להגדיר את השדה travelAdvisory.tollInfo במסכה.

[
  {
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {},
    "distanceMeters": 150338,
    "duration": "5382s",
    "travelAdvisory": {
      "tollInfo": {
        "estimatedPrice": [
          {
            "currencyCode": "USD",
            "units": "4",
            "nanos": 400000000
           }
        ]
      }
    }
  }
]