Trang này được dịch bởi Cloud Translation API.

Tính phí cầu đường

Khi tính toán một tuyến đường hoặc ma trận tuyến đường, bạn nên xem xét bất kỳ khoản phí nào thu phí 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 tuyến đường bằng đơn vị tiền tệ thích hợp.

Hãy xem danh sách Các trạm thu phí được hỗ trợ bên dưới.

Cách tính phí cầu đường

API tuyến đường 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 phí cầu đường có thể áp dụng cho tài xế hoặc phương tiện, cùng các phương thức thanh toán thuận tiện nhất. Nếu không có mức phí cầu đường cho một tuyến đường nhất định, API Routes sẽ cho biết còn có mức phí không xác định.

Để tính toán chính xác thông tin phí cầu đường, API tuyến đường cho bạn tuỳ chọn chỉ định:

Loại khí thải của xe được sử dụng cho tuyến đường (VehicleEmissionType). Nếu không cung cấp loại khí thải, mức phí đối với xe chạy bằng xăng sẽ được trả về.
Mọi mức phí cầu đường cho tài xế hoặc xe có thể áp dụng (TollPass). Nếu bạn không chỉ định phí cầu đường, API sẽ trả về mức giá bằng tiền mặt.
avoidTolls với tư cách RouteModifier để tránh đường có thu phí.

Tính phí cầu đường khi sử dụng trạm thu phí

Ở một số khu vực, người lái xe hoặc phương tiện có phí cầu đường sẽ phải chịu mức phí khác so với những người không có vé. Ví dụ: nếu bạn có phí Tốt để đi! ở Seattle, WA, Hoa Kỳ, bạn sẽ phải trả mức phí thấp hơn so với khi không có thẻ.

Một số khu vực, chẳng hạn như Indonesia, có các con đường yêu cầu đi qua trạm thu phí. Nếu không chỉ định mức phí cầu đường cho một tuyến đường yêu cầu phí cầu đường, thì sẽ không có giá nào được trả về.

Nếu bạn chỉ định một trạm thu phí trong yêu cầu, API sẽ cố gắng trả về giá vé:

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

Tính phí cầu đường cho 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 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 tính toán thông tin phí cầu đường.
Chỉ định loại xe và loại phí cầu đường bằng cách sử dụng trường routeModifiers của yêu cầu. Phí cầu đường được trả về sẽ dựa trên giá mà loại phương tiện và vé đã chỉ định. Nếu bạn chỉ định nhiều lần truy cập, 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 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:
- 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.
Lưu ý: Tuyến đường này chỉ có một chân.

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ề cước phí

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 phí cầu đường cho toàn bộ tuyến đường và 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
            }
          ]
        }
      }
    }
  ]
}

Tính phí cầu đường cho ma trận tuyến đường

Ví dụ sau đây sử dụng phương thức computeRouteMatrix để trả về thông tin phí cầu đường trên một tuyến đường có mức giá ước tính khi phí cầu đường được sử dụng:

Đặt trường mảng extraComputations thành TOLLS để bật tính toán thông tin phí cầu đường.
Hãy 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 điểm tham chiếu origin (điểm xuất phát) của yêu cầu. Phí cầu đường trả về sẽ dựa trên mức giá sử dụng của loại phương tiện và vé đã chỉ định. Nếu bạn chỉ định nhiều lần truyền, thì 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 phí cầu đường trong phản hồi. Chỉ định routes.travelAdvisory.tollInfo để trả về thông tin cho toàn bộ tuyến đường.

Yêu cầu thông tin về phí ma trận tuyến đường

curl -X POST -d '{
"origins": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.340173523716736,
          "longitude":-71.05997968330408
        }
      }
    },
    "routeModifiers": {
      "vehicleInfo":{
        "emissionType": "GASOLINE"
      },
      "tollPasses": [
        "US_MA_EZPASSMA",
        "US_WA_GOOD_TO_GO"
      ]
    }
  }
],
"destinations": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.075698891472804,
          "longitude": -72.59806562080408
        }
      }
    }
  }
],
"travelMode": "DRIVE",
"extraComputations": ["TOLLS"]
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Phản hồi thông tin 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).

Để định cấu hình phương thức trả về thông tin phí cầu đường, hãy sử dụng mặt nạ trường phản hồi để đặt trường travelAdvisory.tollInfo trong mặt nạ đó.

[
  {
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {},
    "distanceMeters": 150338,
    "duration": "5382s",
    "travelAdvisory": {
      "tollInfo": {
        "estimatedPrice": [
          {
            "currencyCode": "USD",
            "units": "4",
            "nanos": 400000000
           }
        ]
      }
    }
  }
]

Vị trí có thu phí được hỗ trợ

Thông tin về cước phí hiện có sẵn cho các địa điểm sau:

Mã vùng	Quốc gia/Vùng	Tiểu bang/Thành phố/Đường có thu phí
Thực tế tăng cường (AR)	Argentina	Buenos Aires
AU	Úc	Brisbane
AU	Úc	Sydney
Brazil	Brazil	Toàn quốc
Indonesia	Indonesia	Toàn quốc
Ấn Độ	Ấn Độ	Toàn quốc
MX (Mexico)	Mexico	Mexico City
US	United States	Alabama
US	United States	Alaska
US	United States	California
US	United States	Colorado
US	United States	Delaware
US	United States	Florida
US	United States	Illinois
US	United States	Iowa
US	United States	Indiana
US	United States	Kansas
US	United States	Louisiana
US	United States	Maine
US	United States	Maryland
US	United States	Massachusetts
US	United States	Michigan
US	United States	Minnesota
US	United States	Missouri
US	United States	New Hampshire
US	United States	New Jersey
US	United States	New York
US	United States	North Carolina
US	United States	Ohio
US	United States	Pennsylvania
US	United States	Rhode Island
US	United States	Nam Carolina
US	United States	Texas
US	United States	Utah
US	United States	Virginia
US	United States	Washington
US	United States	West Virginia

Thông tin này sẽ được cập nhật khi có thêm dữ liệu thu phí.