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