Tính phí cầu đường cho một tuyến đường

Khi tính toán một tuyến đường hoặc ma trận tuyến đường, bạn nên xem xét mọi khoản phí cầu đường trên tuyến đường đó. Đối với một số thành phố, bạn có thể tính phí cầu đường ước tính cho một tuyến đường bằng đơn vị tiền tệ thích hợp.

Để lấy phí cầu đường cho ma trận tuyến đường, hãy xem bài viết Tính phí cầu đường cho ma trận tuyến đường.

Để biết danh sách các vị trí thu phí được hỗ trợ, hãy xem tài liệu tham khảo về TollPass.

Cách tính phí cầu đường

API Tuyến đường tính toán phí cầu đường ước tính, có xem xét mọi khoản chiết khấu giá cầu đường hoặc vé có sẵn cho người lái xe hoặc phương tiện đi lại, cũng như các phương thức thanh toán thuận tiện nhất. Nếu không có phí cầu đường cho một tuyến đường nhất định, API Tuyến đường cho biết có tồn tại phí cầu đường với một mức phí không xác định.

Để có số liệu ước tính chính xác về phí cầu đường, hãy đảm bảo bạn đưa những thông tin sau vào yêu cầu của mình:

  • Loại khí thải của xe sử dụng trên tuyến đường (VehicleEmissionType). Nếu không cung cấp loại khí thải, hệ thống sẽ trả về mức phí cầu đường của xe chạy bằng xăng.
  • Tất cả phí cầu đường mà xe và người lái phải thu bằng cách sử dụng (TollPass). API sẽ dùng phí cầu đường để xác định chính xác phí cầu đường và trả về giá tiền mặt khi phí cầu đường trong yêu cầu không phải là phí cầu đường trên tuyến đường.
  • Nêu rõ các tuyến đường tránh lệ phí cầu đường, nếu cần. Nếu bạn muốn tránh đường có thu phí nếu có thể, hãy thêm avoidTolls làm RouteModifier.

Tính phí cầu đường bằng phí cầu đường

Để tính phí cầu đường bằng phí cầu đường, bạn cần chỉ định mọi khoản phí cầu đường trong yêu cầu. Sau đó, API sẽ trả về giá vé.

  • Nếu bạn chỉ định phí cầu đường không hợp lệ, khoản phí này sẽ bị bỏ qua.

  • Nếu chỉ định nhiều lần thu phí cầu đường dưới dạng một mảng, API sẽ cố gắng tính toán giá cho tuyến đường của mỗi lần truyền.

Cách thức hoạt động của thẻ thu phí có thể khác nhau tuỳ theo khu vực.

  • Mức phí có thể thấp hơn khi có phí cầu đường: Ở một số khu vực, người lái xe hoặc phương tiện có phí cầu đường sẽ trả mức phí khác so với những người không có phí cầu đường. Ví dụ: nếu bạn có vé thu phí Good To Go! ở Seattle, WA, US, bạn sẽ phải trả mức phí thấp hơn so với trường hợp bạn không có thẻ và vé.

  • Một số đường có thể yêu cầu phí cầu đường: Một số khu vực (chẳng hạn như Indonesia) có những đường yêu cầu phí cầu đường. Nếu bạn không chỉ định phí cầu đường cho tuyến đường yêu cầu phí cầu đường, API sẽ không trả về phí cầu đường.

Tính phí cầu đường cho một tuyến đường

Ví dụ sau đây sử dụng phương thức computeRoutes để trả về thông tin thu phí cầu đường cùng với giá ước tính khi sử dụng phí cầu đường. Trong ví dụ này, bạn:

  • Đặt trường mảng extraComputations thành TOLLS để cho phép tính toán thông tin thu phí cầu đường.

  • Chỉ định loại xe và loại phí cầu đường bằng cách sử dụng trường routeModifiers của yêu cầu. Phí cầu đường được trả về dựa trên giá sử dụng của loại xe và vé được chỉ định. Nếu có nhiều lượt truyền được chỉ định, thì giá thấp nhất sẽ được trả về.

  • Sử dụng mặt nạ trường phản hồi để định cấu hình phương thức trả về thông tin tính phí trong phản hồi. Trong ví dụ này, yêu cầu bao gồm các thuộc tính sau trong mặt nạ trường phản hồi:

    • Trường routes.travelAdvisory.tollInfo để trả về thông tin cho toàn bộ tuyến.

    • routes.legs.travelAdvisory.tollInfo để trả về thông tin cho mỗi chặng.

Yêu cầu thông tin thu phí cầu đường

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'

Phản hồi có chứa thông tin về phí cầu đường

Phản hồi chứa thông tin về phí cầu đường trong đối tượng TollInfo (REST) hoặc TollInfo (gRPC). Trong ví dụ này, bạn trả về thông tin thu phí cho toàn bộ tuyến đường và cho mỗi chặng của tuyến đường.

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