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

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

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

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