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

المطوّرون في المنطقة الاقتصادية الأوروبية

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

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

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