محاسبه هزینه عوارض برای یک مسیر

هنگامی که یک مسیر یا یک ماتریس مسیر را محاسبه می کنید، ممکن است بخواهید هر گونه هزینه عوارض در مسیر را در نظر بگیرید. برای شهرهای منتخب، می‌توانید هزینه تخمینی عوارض یک مسیر را با ارز مناسب محاسبه کنید.

برای دریافت عوارض برای ماتریس مسیر، به محاسبه هزینه عوارض برای ماتریس مسیر مراجعه کنید.

برای لیست مکان های عوارض پشتیبانی شده، به مرجع TollPass مراجعه کنید

نحوه محاسبه عوارض

Routes API هزینه تخمینی عوارض را با در نظر گرفتن هر گونه تخفیف در قیمت عوارض یا مجوزهای موجود برای راننده یا وسیله نقلیه و راحت‌ترین روش‌های پرداخت محاسبه می‌کند. اگر قیمت عوارضی برای یک مسیر مشخص وجود نداشته باشد، Routes API وجود عوارضی با هزینه نامشخص را نشان می دهد.

به منظور محاسبه دقیق اطلاعات عوارض، Routes API به شما این امکان را می دهد که مشخص کنید:

  • نوع انتشار وسیله نقلیه مورد استفاده برای مسیر ( VehicleEmissionType ). اگر نوع آلایندگی ارائه نشده باشد، عوارض خودروهای بنزینی برگردانده می شود.
  • هر گونه عوارضی که ممکن است برای راننده یا وسیله نقلیه اعمال شود ( TollPass ). اگر هیچ گذر عوارضی مشخص نشده باشد، API قیمت نقدی را برمی‌گرداند.
  • avoidTolls به عنوان RouteModifier برای جلوگیری از عوارض جاده ها.

محاسبه عوارض در هنگام استفاده از کارت عوارض

در برخی مناطق، راننده یا وسیله نقلیه ای که دارای کارت عوارضی است، عوارض متفاوتی نسبت به کسانی که کارت ندارند، پرداخت می کند. به عنوان مثال، اگر شما یک Good To Go دارید! کارت عوارضی در سیاتل، WA، ایالات متحده، شما عوارض کمتری نسبت به نداشتن کارت دریافت می کنید.

برخی از مناطق، مانند اندونزی، دارای جاده هایی هستند که نیاز به اخذ عوارض دارند. اگر برای مسیری که در آن کارت عوارضی لازم است، کارت عوارضی مشخص نشده باشد، قیمتی برگردانده نمی شود.

اگر عوارضی را به عنوان بخشی از درخواست مشخص کنید، API سعی می‌کند قیمت عبور را برگرداند:

  • اگر یک کارت عوارضی نامعتبر را مشخص کنید، گذرنامه نادیده گرفته می شود.

  • شما می توانید چندین گذر از عوارض را به عنوان یک آرایه مشخص کنید. API تلاش می کند تا قیمت عبور مسیر را برای هر گذر محاسبه کند.

محاسبه هزینه عوارض برای یک مسیر

مثال زیر از روش computeRoutes برای برگرداندن اطلاعات عوارض با قیمت تخمینی در هنگام استفاده از کارت عوارض استفاده می کند. در این مثال، شما:

  • برای فعال کردن محاسبه اطلاعات عوارض، فیلد آرایه extraComputations را روی TOLLS تنظیم کنید.

  • با استفاده از قسمت routeModifiers درخواست، نوع وسیله نقلیه و نوع کارت عوارضی را مشخص کنید. قیمت عوارض برگشتی بر اساس قیمت استفاده شده توسط نوع خودرو و پاس مشخص شده است. اگر بیش از یک پاس مشخص شده باشد، کم هزینه ترین قیمت برگشت داده می شود.

  • از ماسک فیلد پاسخ برای پیکربندی روش برای برگرداندن اطلاعات عوارض در پاسخ استفاده کنید. در این مثال، درخواست شامل ویژگی های زیر در ماسک فیلد پاسخ بود:

    • قسمت routes.travelAdvisory.tollInfo برای بازگرداندن اطلاعات کل مسیر.

    • routes.legs.travelAdvisory.tollInfo برای بازگرداندن اطلاعات برای هر پا.

درخواست اطلاعات عوارض

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "extraComputations": ["TOLLS"],
  "routeModifiers":{
    "vehicleInfo":{
      "emissionType": "GASOLINE"
    },
    "tollPasses": [
      "US_MA_EZPASSMA",
      "US_WA_GOOD_TO_GO"
    ]
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

پاسخ حاوی اطلاعات عوارض

پاسخ حاوی اطلاعاتی در مورد عوارض در یک شیء TollInfo (REST) ​​یا TollInfo (gRPC) است. در این مثال، شما اطلاعات عوارض را برای کل مسیر و برای هر قسمت از مسیر برمی گردانید.

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}