با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA).
هنگامی که یک مسیر یا یک ماتریس مسیر را محاسبه می کنید، ممکن است بخواهید هر گونه هزینه عوارض در مسیر را در نظر بگیرید. برای شهرهای منتخب، می‌توانید هزینه تخمینی عوارض یک مسیر را با ارز مناسب محاسبه کنید.
برای لیست مکان‌های عوارض پشتیبانی شده، به مرجع TollPass مراجعه کنید.
نحوه محاسبه عوارض
Routes API هزینه تخمینی عوارض را با در نظر گرفتن هر گونه تخفیف در قیمت عوارض یا مجوزهای موجود برای راننده یا وسیله نقلیه و راحت‌ترین روش‌های پرداخت محاسبه می‌کند. اگر قیمت عوارضی برای یک مسیر مشخص وجود نداشته باشد، Routes API وجود عوارضی با هزینه نامشخص را نشان می دهد.
برای به دست آوردن برآورد دقیق عوارض، مطمئن شوید که اطلاعات زیر را در درخواست خود لحاظ کرده اید:
نوع انتشار وسیله نقلیه مورد استفاده برای مسیر ( VehicleEmissionType ). اگر نوع آلایندگی ارائه نشده باشد، عوارض خودروهای بنزینی برگردانده می شود.
تمام عوارضی که وسیله نقلیه و راننده از ( TollPass ) استفاده می کنند. API از کارت‌های عوارض برای تعیین هزینه‌های دقیق عوارض استفاده می‌کند و زمانی که مجوزهای دریافت عوارض در درخواست محلی برای مسیر نباشد، قیمت‌های نقدی را برمی‌گرداند.
در صورت لزوم اجتناب از عوارض را مشخص کنید . اگر می‌خواهید در صورت امکان از جاده‌های عوارضی اجتناب کنید، avoidTolls به عنوان RouteModifier اضافه کنید.
محاسبه عوارض با استفاده از کارت عوارض
برای محاسبه عوارض با استفاده از گذرنامه، هر گونه گذراندن عوارض را به عنوان بخشی از درخواست مشخص می‌کنید. سپس API قیمت های عبور را برمی گرداند.
اگر یک کارت عوارضی نامعتبر را مشخص کنید، گذرنامه نادیده گرفته می شود.
اگر چندین گذر عوارض را به عنوان یک آرایه مشخص کنید، API تلاش می کند تا قیمت مسیر را برای هر عبور محاسبه کند.
نحوه رفتار گذرهای عوارض می‌تواند بسته به منطقه متفاوت باشد.
ممکن است نرخ‌ها با کارت عوارض کمتر باشد : در برخی مناطق، راننده یا وسیله نقلیه‌ای با کارت عوارضی عوارض متفاوتی نسبت به کسانی که کارت ندارند پرداخت می‌کنند. به عنوان مثال، اگر شما یک Good To Go دارید! کارت عوارضی در سیاتل، WA، ایالات متحده، شما عوارض کمتری نسبت به نداشتن کارت دریافت می کنید.
برخی از جاده‌ها ممکن است به کارت عوارضی نیاز داشته باشند : برخی از مناطق، مانند اندونزی، جاده‌هایی دارند که نیاز به دریافت عوارض دارند. اگر برای مسیری که در آن مجوز دریافت عوارض الزامی است، کارت عوارضی تعیین نکنید، API هزینه عوارضی را برنمی‌گرداند.
محاسبه هزینه عوارض برای یک مسیر
مثال زیر از روش computeRoutes برای برگرداندن اطلاعات عوارض با قیمت تخمینی در هنگام استفاده از کارت عوارض استفاده می کند. در این مثال، شما:
برای فعال کردن محاسبه اطلاعات عوارض، فیلد آرایه extraComputations را روی TOLLS تنظیم کنید.
با استفاده از قسمت routeModifiers درخواست، نوع وسیله نقلیه و نوع کارت عوارضی را مشخص کنید. قیمت عوارض برگشتی بر اساس قیمت استفاده شده توسط نوع خودرو و پاس مشخص شده است. اگر بیش از یک پاس مشخص شده باشد، کم هزینه ترین قیمت برگشت داده می شود.
از ماسک فیلد پاسخ برای پیکربندی روش برای برگرداندن اطلاعات عوارض در پاسخ استفاده کنید. در این مثال، درخواست شامل ویژگی های زیر در ماسک فیلد پاسخ بود:
قسمت routes.travelAdvisory.tollInfo برای بازگرداندن اطلاعات کل مسیر.
routes.legs.travelAdvisory.tollInfo برای بازگرداندن اطلاعات برای هر پا.
پاسخ حاوی اطلاعاتی در مورد عوارض در یک شیء TollInfo (REST) یا TollInfo (gRPC) است. در این مثال، شما اطلاعات عوارض را برای کل مسیر و برای هر قسمت از مسیر برمی گردانید.
تاریخ آخرین بهروزرسانی 2025-08-09 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-09 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Routes API can calculate estimated toll fees for routes in select cities, taking into account toll discounts, passes, and payment methods.\u003c/p\u003e\n"],["\u003cp\u003eTo get accurate toll estimates, specify the vehicle's emission type, any applicable toll passes, and whether to avoid tolls using RouteModifiers.\u003c/p\u003e\n"],["\u003cp\u003eToll pass usage can result in lower rates or may be required for certain roads, with the API attempting to calculate prices based on provided passes.\u003c/p\u003e\n"],["\u003cp\u003eRequests calculating tolls are billed at a higher rate, and the returned \u003ccode\u003eestimatedPrice\u003c/code\u003e applies to non-commercial vehicles, potentially differing for commercial ones.\u003c/p\u003e\n"],["\u003cp\u003eToll information can be obtained by setting \u003ccode\u003eextraComputations\u003c/code\u003e to \u003ccode\u003eTOLLS\u003c/code\u003e, specifying vehicle and toll pass details in \u003ccode\u003erouteModifiers\u003c/code\u003e, and using a response field mask to include tollInfo in the output.\u003c/p\u003e\n"]]],["The Routes API can compute estimated toll fees for routes, considering toll discounts and payment methods. Accurate toll calculations require specifying vehicle emission type and applicable toll passes. The API returns cash prices if no passes are specified. Toll passes can offer lower rates or be mandatory in some regions. To get toll information, include \"TOLLS\" in `extraComputations` and specify toll passes in `routeModifiers`. The API then returns the toll prices in the response, which may vary by the requested toll passes.\n"],null,["# Calculate toll fees for a route\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nWhen you are computing a route or a route matrix,\nyou might want to take into consideration any toll fees on the route.\nFor select cities, you can compute the estimated\ntoll fee for a route in the appropriate currency.\n\nTo get tolls for a route matrix, see\n[Calculate tolls fees for a route matrix](/maps/documentation/routes/calculate_toll-rm).\n\nFor the list of supported toll locations, see the reference for\n[TollPass](/maps/documentation/routes/reference/rest/v2/RouteModifiers#tollpass).\n| **Caution:** Requests that calculate toll fees are billed at a higher rate. [Learn more about billing](/maps/documentation/routes/usage-and-billing) for the Routes API.\n\nHow tolls are calculated\n------------------------\n\nThe Routes API calculates the estimated toll fee,\ntaking into consideration any toll price discounts or passes available\nto the driver or vehicle, and the most convenient payment methods.\nIf there is no available toll price for a given route,\nthe Routes API indicates the existence of a toll\nwith an unknown fee.\n| **Note** : The Routes API calculates tolls on a route differently than Google Maps:\n|\n| - The Routes API returns only the toll prices (pass or cash) that would actually be charged for the trip, assuming your request accurately represents what types of passes each driver and/or vehicle has. If you don't specify any toll passes, the API returns the cash prices, which is usually the highest toll.\n| - Google Maps typically returns the cheapest possible price for a vehicle. Users cannot specify which toll passes they have; instead, to see cash tolls, users can disable the **See toll pass prices** option, which is enabled by default.\n\nTo get accurate toll estimates, make sure you include the following information\nin your request:\n\n- **The emission type** of the vehicle used for the route ([`VehicleEmissionType`](/maps/documentation/routes/reference/rest/v2/RouteModifiers#vehicleemissiontype)). If no emission type is provided, the toll for a gasoline-fueled vehicle is returned.\n- **All toll passes the vehicle and driver have** using ([`TollPass`](/maps/documentation/routes/reference/rest/v2/RouteModifiers#tollpass)). The API uses the toll passes to determine accurate toll fees, and returns cash prices when toll passes in the request are not local to the route.\n- **Specify avoid tolls, if needed** . If you want to avoid toll roads where possible, add `avoidTolls` as a `RouteModifier`.\n\n### Calculate tolls using a toll pass\n\nTo calculate tolls using a toll pass, you specify any toll passes as part of\nthe request. The API then returns pass prices.\n\n- If you specify an invalid toll pass, the pass is ignored.\n\n- If specify multiple toll passes as an array, the API attempts to\n calculate the price for the route for each pass.\n\n| **Note:** You can only specify a toll pass for the `DRIVE` and `TWO_WHEELER` travel modes.\n\nThe way toll passes behave can vary by region.\n\n- **Rates may be lower with a toll pass** : In some regions, a driver or vehicle\n with a toll pass pays a different toll than those who don't have a pass.\n For example, if you have a\n [Good To Go!](https://en.wikipedia.org/wiki/Good_to_Go_(toll_collection_system))\n toll pass in Seattle, WA, US, you pay a lower toll than if you don't have a\n pass.\n\n- **Some roads may require a toll pass**: Some regions, such as Indonesia, have\n roads that require a toll pass. If you don't specify a toll pass for a\n route where a toll pass is required, the API does not return a toll price.\n\nCalculate toll fees for a route\n-------------------------------\n\nThe following example uses the\n[`computeRoutes`](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes)\nmethod to return toll information with an estimated\nprice when a toll pass is used. In this example, you:\n\n- Set the `extraComputations` array field to `TOLLS` to enable the calculation\n of toll information.\n\n- Specify the vehicle type and the toll pass type by using the\n `routeModifiers` field of the request. The toll price returned is based on\n the pricing used by the specified vehicle type and pass. If more than one\n pass is specified, the least expensive pricing is returned.\n\n- Use the [response field mask](/maps/documentation/routes/choose_fields) to configure the method to\n return toll information in the response. In this example, the request\n included the following properties in the response field mask:\n\n - `routes.travelAdvisory.tollInfo` field to return information for the\n entire route.\n\n - `routes.legs.travelAdvisory.tollInfo` to return information\n for each leg.\n\n | **Note:** This route contains only one leg.\n\n### Request for toll information\n\n```console\ncurl -X POST -d '{\n \"origin\":{\n \"location\":{\n \"latLng\":{\n \"latitude\":42.340173523716736,\n \"longitude\":-71.05997968330408\n }\n }\n },\n \"destination\":{\n \"location\":{\n \"latLng\":{\n \"latitude\":42.075698891472804,\n \"longitude\": -72.59806562080408\n }\n }\n },\n \"travelMode\": \"DRIVE\",\n \"extraComputations\": \\[\"TOLLS\"\\],\n \"routeModifiers\":{\n \"vehicleInfo\":{\n \"emissionType\": \"GASOLINE\"\n },\n \"tollPasses\": [\n \"US_MA_EZPASSMA\",\n \"US_WA_GOOD_TO_GO\"\n ]\n }\n}' \\\n-H 'Content-Type: application/json' \\\n-H 'X-Goog-Api-Key: \u003cvar translate=\"no\"\u003eYOUR_API_KEY\u003c/var\u003e' \\\n-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \\\n'https://routes.googleapis.com/directions/v2:computeRoutes'\n```\n\n### Response containing toll information\n\nThe response contains information on tolls in a\n[TollInfo](/maps/documentation/routes/reference/rest/v2/TollInfo) (REST) or\n[TollInfo](/maps/documentation/routes/reference/rpc/google.maps.routing.v2#tollinfo) (gRPC) object. In this\nexample, you return toll information for the entire route and for each leg of\nthe route.\n| **Note** : The Routes API provides an `estimatedPrice` that applies to non-commercial vehicles.\n|\n| - Toll prices may be different for commercial vehicles.\n- The `units` and `nanos` are omitted when their value is zero. \n\n```json\n{\n \"routes\": [\n {\n \"legs\": [\n {\n \"travelAdvisory\": {\n \"tollInfo\": {\n \"estimatedPrice\": [\n {\n \"currencyCode\": \"USD\",\n \"units\": \"4\",\n \"nanos\": 400000000\n }\n ]\n }\n }\n }\n ],\n \"distanceMeters\": 150338,\n \"duration\": \"6650s\",\n \"travelAdvisory\": {\n \"tollInfo\": {\n \"estimatedPrice\": [\n {\n \"currencyCode\": \"USD\",\n \"units\": \"4\",\n \"nanos\": 400000000\n }\n ]\n }\n }\n }\n ]\n}\n```"]]
