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