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

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

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

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