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