هنگام محاسبه ماتریس مسیر، ممکن است بخواهید هرگونه هزینه عوارض در مسیرهای موجود در ماتریس را در نظر بگیرید. برای شهرهای منتخب، میتوانید هزینه عوارض تخمینی برای یک مسیر را با واحد پول مناسب محاسبه کنید.
برای دریافت عوارض یک مسیر، به بخش محاسبه هزینه عوارض یک مسیر مراجعه کنید.
برای فهرست مکانهای دارای عوارض پشتیبانیشده، به مرجع 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 } ] } } } ]