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

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Khi tính toán một tuyến đường hoặc ma trận tuyến đường, bạn có thể muố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.

Để xem 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.

Để xem danh sách các địa điểm có 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 giảm giá hoặc thẻ cầu đường hiện có 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á cầu đường cho một tuyến đường nhất định, thì Routes API sẽ cho biết sự tồn tại của một trạm thu phí với mức phí không xác định.

Để nhận được thông tin ước tính chính xác về phí cầu đường, hãy đảm bảo bạn đưa các thông tin sau vào yêu cầu:

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

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

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

  • Nếu bạn chỉ định một thẻ phí cầu đường không hợp lệ, thẻ đó sẽ bị bỏ qua.

  • Nếu bạn chỉ định nhiều phí cầu đường dưới dạng một mảng, API sẽ cố gắng tính giá cho tuyến đường đối với từng phí.

Cách hoạt động của phí cầu đường có thể thay đổi tuỳ theo khu vực.

  • Mức phí có thể thấp hơn khi sử dụng thẻ cầu đường: Ở một số khu vực, người lái xe hoặc phương tiện có thẻ cầu đường sẽ trả một mức phí cầu đường khác với những người không có thẻ. Ví dụ: nếu bạn có thẻ cầu đường Good To Go! ở Seattle, WA, Hoa Kỳ, bạn sẽ trả mức phí cầu đường thấp hơn so với khi bạn 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ó những đường yêu cầu phí cầu đường. Nếu bạn không chỉ định phí cầu đường cho một tuyến đường yêu cầu phí cầu đường, thì API sẽ không trả về giá cầu đường.

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

Ví dụ sau đây sử dụng phương pháp 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 để bật tính năng tính toán thông tin về phí cầu đường.

  • Chỉ định loại phương tiện và loại phí cầu đường 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 mức giá mà loại phương tiện và thẻ được chỉ định sử dụng. Nếu bạn chỉ định nhiều thẻ, thì mức giá rẻ 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 về phí cầu đường 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 từng chặng.

Yêu cầu thông tin về 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ề 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 sẽ 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
            }
          ]
        }
      }
    }
  ]
}