Trang này được dịch bởi Cloud Translation API.

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 có thể muốn tính đến 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 toán giá trị ước tính phí cầu đường bằng đơn vị tiền tệ thích hợp.

Để thu phí cầu đường cho ma trận tuyến đường, hãy xem Tính phí cầu đường cho ma trận tuyến đường.

Để biết danh sách các địa điểm thu phí được hỗ trợ, hãy xem tài liệu tham khảo cho 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ó cân nhắc đến các khoản chiết khấu giá cầu đường hoặc phí cầu đường có sẵn cho người lái hoặc xe và các phương thức thanh toán thuận tiện nhất. Nếu không có sẵn phí cầu đường cho một tuyến đường nhất định, API Tuyến đường cho biết sự tồn tại của phí cầu đường với mức phí không xác định.

Lưu ý: API Tuyến tính sẽ tính toán phí cầu đường trên tuyến đường khác với Google Maps:

API Tuyến đường chỉ trả về phí cầu đường (thẻ hoặc tiền mặt) mà sẽ thực sự bị tính phí cho chuyến đi, giả sử yêu cầu của bạn là chính xác thể hiện các loại thẻ và vé mà mỗi người lái xe và/hoặc phương tiện có. Nếu bạn không chỉ định phí cầu đường, API sẽ trả về giá tiền mặt, tức là thường là mức phí cầu đường cao nhất.
Google Maps thường trả về giá rẻ nhất có thể cho một chiếc xe. Người dùng không thể chỉ định loại phí cầu đường họ được sử dụng; thay vào đó, để xem phí cầu đường, người dùng có thể tắt tuỳ chọn Xem phí cầu đường, tức là bật theo mặc định.

Để có số liệu ước tính phí cầu đường chính xác, hãy nhớ cung cấp những thông tin sau trong yêu cầu của bạn:

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, mức thu phí cho xe chạy bằng xăng sẽ là bị trả lại.
Toàn bộ phí cầu đường mà xe và tài xế có 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ả lại giá bằng tiền mặt khi phí cầu đường trong yêu cầu không phải là cục bộ 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í 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 chỉ định bất kỳ phí cầu đường nào là một phần của 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 phí cầu đường dưới dạng một mảng, API sẽ cố gắng tính giá hành trình cho mỗi lượt đi.

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 nếu có phí cầu đường: Ở một số khu vực, người lái xe hoặc phương tiện vận chuyển có thẻ tính phí cầu đường sẽ trả mức phí khác với người không có thẻ/vé. Ví dụ: nếu bạn có một Được thôi! phí cầu đường ở Seattle, Washington, Hoa Kỳ, bạn sẽ phải trả mức phí thấp hơn so với khi bạn không có .
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ó đường bắt buộc thu 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ả lại thông tin thu phí cầu đường với số liệu ước tính giá khi sử dụng phí cầu đường. Trong ví dụ này, bạn:

Đặt trường mảng extraComputations thành TOLLS để bật phép tính 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. Giá điện cầu đường được trả lại dựa trên giá áp dụng cho loại xe và vé được chỉ định. Nếu có nhiều hơn một thẻ/vé đượ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 nhằm trả lại thông tin số điện thoại trong câu trả lờ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 đường.
- routes.legs.travelAdvisory.tollInfo để trả về thông tin cho mỗi chặng.
Lưu ý: Tuyến đường này chỉ có một 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ề trạm thu phí cầu đường TollInfo (REST) hoặc Đối tượng TollInfo (gRPC). Trong phần này ví dụ: bạn trả về thông tin thu phí cầu đường cho toàn bộ tuyến đường và cho mỗi chặng của tuyến đường đó.

Lưu ý: API Tuyến cung cấp estimatedPrice áp dụng cho xe phi thương mại.

Phí cầu đường có thể khác đối với xe thương mại.
units và nanos sẽ bị bỏ qua khi giá trị của chúng bằng 0.

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