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