احتساب رسوم العبور بمصفوفة مسار

عند حساب مصفوفة مسار، قد ترغب في مراعاة أي رسوم عبور على المسارات في المصفوفة. بالنسبة لمدن محددة، يمكنك حساب رسوم العبور المقدرة للطريق بالعملة المناسبة.

للحصول على رسوم عبور لمسار، راجع حساب رسوم العبور لمسار.

للحصول على قائمة بمواقع رسوم العبور المتوافقة، يُرجى الاطّلاع على مرجع 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
           }
        ]
      }
    }
  }
]