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.

Để 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 đị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ó 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.

Để 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.
  • 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 có thu phí có thể, hãy thêm avoidTolls làm RouteModifier.

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

Để 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 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 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 thẻ thu phí bằng cách sử dụng trường routeModifiers của yêu cầu. Phí 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 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 đường.

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

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

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 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.

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