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 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ệ phù 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í có thu phí được hỗ trợ, hãy xem thông tin 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ó tính đến mọi chiết khấu hoặc thẻ thông hành có sẵn 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 có phí cầu đường nhưng không xác định được mức phí.

Để 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 được dùng cho tuyến đường (VehicleEmissionType). Nếu không cung cấp loại khí thải, thì phí cầu đường cho xe chạy bằng xăng sẽ được trả về.
  • Tất cả thẻ thu phí mà xe và người lái xe có bằng cách 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á tiền mặt khi thẻ thu phí trong yêu cầu không phải là thẻ đị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 làm 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á của thẻ và vé.

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

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

Cách 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 bạn có thẻ thu phí: Ở một số khu vực, người lái xe hoặc xe có thẻ thu phí 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 có thẻ thu phí Good To Go! ở Seattle, Washington, Hoa Kỳ, bạn sẽ 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ó những con đường yêu cầu thẻ thu phí. Nếu bạn không chỉ định thẻ thu phí cho một tuyến đường bắt buộc phải có thẻ thu phí, thì API sẽ không trả về giá 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 mức giá ước tính khi sử dụng thẻ thu phí. 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 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 mức giá mà loại xe và thẻ đã chỉ định sử dụng. Nếu bạn chỉ định nhiều thẻ và vé, thì 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 cung cấp 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 này 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
            }
          ]
        }
      }
    }
  ]
}