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

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

فهرست مکان‌های عوارض پشتیبانی شده را در زیر ببینید.

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

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
            }
          ]
        }
      }
    }
  ]
}

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

مثال زیر از متد 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
           }
        ]
      }
    }
  }
]

مکان های عوارض پشتیبانی شده

اطلاعات عوارض در حال حاضر برای مکان های زیر در دسترس است:

کد منطقه کشور/منطقه ایالت/شهر/جاده عوارضی
AR آرژانتین بوینس آیرس
AU استرالیا بریزبن
AU استرالیا سیدنی
BR برزیل در سراسر کشور
شناسه اندونزی در سراسر کشور
که در هند در سراسر کشور
MX مکزیک مکزیکوسیتی
ایالات متحده ایالات متحده آلاباما
ایالات متحده ایالات متحده آلاسکا
ایالات متحده ایالات متحده کالیفرنیا
ایالات متحده ایالات متحده کلرادو
ایالات متحده ایالات متحده دلاور
ایالات متحده ایالات متحده فلوریدا
ایالات متحده ایالات متحده ایلینوی
ایالات متحده ایالات متحده آیووا
ایالات متحده ایالات متحده ایندیانا
ایالات متحده ایالات متحده کانزاس
ایالات متحده ایالات متحده لوئیزیانا
ایالات متحده ایالات متحده مین
ایالات متحده ایالات متحده مریلند
ایالات متحده ایالات متحده ماساچوست
ایالات متحده ایالات متحده میشیگان
ایالات متحده ایالات متحده مینه سوتا
ایالات متحده ایالات متحده میسوری
ایالات متحده ایالات متحده نیوهمپشایر
ایالات متحده ایالات متحده نیوجرسی
ایالات متحده ایالات متحده نیویورک
ایالات متحده ایالات متحده کارولینای شمالی
ایالات متحده ایالات متحده اوهایو
ایالات متحده ایالات متحده پنسیلوانیا
ایالات متحده ایالات متحده رود آیلند
ایالات متحده ایالات متحده کارولینای جنوبی
ایالات متحده ایالات متحده تگزاس
ایالات متحده ایالات متحده یوتا
ایالات متحده ایالات متحده ویرجینیا
ایالات متحده ایالات متحده واشنگتن
ایالات متحده ایالات متحده ویرجینیای غربی

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