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 nên cân nhắc 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 phí cầu đường ước tính cho một tuyến đường bằng đơn vị tiền tệ thích hợp.

Để biết phí cầu đường cho một ma trận tuyến đường, hãy xem phần Tính phí cầu đường cho một 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

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

Lưu ý: Routes API tính toán phí cầu đường trên một tuyến đường theo cách khác với Google Maps:

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

Để nhận được thông tin ước tính chính xác về phí cầu đường, 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 dùng cho tuyến đường đó (VehicleEmissionType). Nếu bạn không cung cấp loại khí thải, hệ thống sẽ trả về phí cầu đường cho xe chạy bằng xăng.
Tất cả thẻ thu phí mà xe và người lái xe có sử dụng (TollPass). API sử dụng thẻ thu phí để xác định chính xác phí cầu đường và trả về giá bằng tiền mặt khi thẻ thu phí trong yêu cầu không phải là thẻ thu phí tại địa phương của tuyến đường.
Chỉ định tránh trạm thu phí (nếu cần). Nếu bạn muốn tránh đường thu phí khi có thể, hãy thêm avoidTolls dưới dạng RouteModifier.

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

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

Nếu bạn chỉ định thẻ thu phí không hợp lệ, thẻ đó sẽ bị bỏ qua.
Nếu bạn chỉ định nhiều thẻ đường thu phí dưới dạng một mảng, API sẽ cố gắng tính toán giá cho tuyến đường cho mỗi thẻ.

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

Mức giá có thể thấp hơn khi có thẻ thu phí: Ở một số khu vực, người lái xe hoặc xe có thẻ thu phí sẽ phải trả phí khác với những người không có thẻ. Ví dụ: nếu có thẻ thu phí Good To Go! ở Seattle, Washington, Hoa Kỳ, bạn sẽ phải trả phí thấp hơn so với khi không có thẻ.
Một số đường có thể yêu cầu thẻ thu phí: Một số khu vực, chẳng hạn như Indonesia, có các đường cần có thẻ thu phí. Nếu bạn không chỉ định thẻ đường thu phí cho một tuyến đường bắt buộc phải có thẻ đường thu phí, thì API sẽ không trả về giá đường thu phí.

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 về phí cầu đường kèm theo giá ước tính khi sử dụng thẻ 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 về phí cầu đường.
Chỉ định loại xe và loại thẻ thu phí bằng cách sử dụng trường routeModifiers của yêu cầu. Giá cầu đường được trả về dựa trên giá mà loại xe và thẻ được chỉ định sử dụng. Nếu bạn chỉ định nhiều thẻ và vé, hệ thống sẽ trả về mức giá rẻ nhất.
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 đường thu 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 từng chặng.
Lưu ý: Tuyến này chỉ có một chặng.

Yêu cầu cung cấp thông tin về đường thu phí

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 chứa thông tin về phí cầu đường

Nội dung 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 về phí cầu đường cho toàn bộ tuyến đường và cho từng chặng của tuyến đường.

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

Giá đường thu phí có thể khác đối với xe thương mại.
units và nanos 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
            }
          ]
        }
      }
    }
  ]
}