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

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

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

للاطّلاع على قائمة بالمواقع الجغرافية التي تتوفر فيها خدمة دفع رسوم المرور، راجِع مرجع TollPass.

مثال على رسوم المرور في مصفوفة الطرق

يستخدم المثال التالي طريقة computeRouteMatrix لعرض معلومات الرسوم على طريق يتضمّن سعرًا تقديريًا عند استخدام بطاقة دفع الرسوم:

• اضبط حقل مصفوفة extraComputations على TOLLS لتفعيل احتساب معلومات رسوم المرور.

• حدِّد نوع المركبة ونوع بطاقة المرور باستخدام الحقل routeModifiers لنقاط طريق origin في الطلب. ويستند سعر رسوم العبور الذي يتم عرضه إلى السعر الذي يستخدمه نوع المركبة وبطاقة العبور المحدّدان. في حال تحديد أكثر من بطاقة، سيتم عرض أقل سعر.

• استخدِم قناع حقل الردّ لضبط طريقة عرض معلومات الرسوم في الردّ. حدِّد 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
           }
        ]
      }
    }
  }
]