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

Khi tính toán 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.

Để biết phí cầu đường cho ma trận tuyến đường, hãy xem phần 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ầu đường đượ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 phí cầu đường ước tính, cân nhắc mọi khoản chiết khấu hoặc vé cầu đường dành cho người lái xe hoặc xe, 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 sẽ cho biết có trạm thu phí với mức phí không xác định.

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

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

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

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

Cách thức xử lý phí cầu đường có thể khác nhau tuỳ theo khu vực.

  • Mức phí có phí cầu đường có thể thấp hơn: Ở 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 với những người không có thẻ. Ví dụ: nếu có thẻ thu phí Good To Go! tại Seattle, WA, US, bạn sẽ trả mức phí thấp hơn so với trường hợp bạn không có thẻ thông hành.

  • 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 đoạn đườ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ề 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 phí cầu đường với giá ước tính khi phí cầu đường được sử dụ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 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ề sẽ dựa trên giá của loại phương tiện được chỉ định và thẻ và vé. Nếu chỉ định nhiều lượt, 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 số điện thoại tính phí trong phản hồi. Trong ví dụ này, yêu cầu đưa các thuộc tính sau vào 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'

Câu trả lời có chứa thông tin về số điện thoại tính phí cầu đường

Phản hồi chứa thông tin về phí cầu đường trong một đố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 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
            }
          ]
        }
      }
    }
  ]
}