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

عند احتساب مصفوفة المسارات، قد تحتاج إلى مراعاة أي رسوم رسوم مرور على المسارات الواردة في المصفوفة. في مدن محدّدة، يمكنك احتساب رسوم المرور المقدَّرة لمسار معيّن بالعملة المناسبة.

للحصول على الرسوم مقابل مسار معيّن، يُرجى الاطّلاع على مقالة احتساب رسوم الطرق مقابل مسار معيّن.

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