API Tuyến đường hiện đang ở chế độ Xem trước (trước GA). Các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không được hỗ trợ hạn chế. Đồng thời, các thay đổi đối với sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không tương thích với các phiên bản trước giai đoạn phát hành rộng rãi khác. Các Sản phẩm trước giai đoạn phát hành rộng rãi chịu sự điều chỉnh của Điều khoản dành riêng cho dịch vụ nền tảng Google Maps. Để biết thêm thông tin, hãy xem nội dung mô tả giai đoạn ra mắt.

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

Switch to English

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 có thể cân nhắc đế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 phí cầu đường ước tính cho một tuyến đường bằng đơn vị tiền tệ thích hợp.

Hãy xem danh sách Vị trí có 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ó 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ó phí cầu đường cho một tuyến đường nhất định, thì API tuyến đường cho biết phí cầu đường có tồn tại với một khoản 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 phép bạ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, thì phí cầu đường cho xe chạy bằng nhiên liệu xăng sẽ được trả về.
Mọi phí cầu đường cho tài xế hoặc xe có thể áp dụng (TollPass). Nếu không chỉ định phí cầu đường, API sẽ trả về giá tiền mặt.
avoidTolls với tư cách là RouteModifier để tránh các đoạn đường có thu phí.

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

Ở một số khu vực, người lái xe hoặc xe có phí cầu đường khác với phí cầu đường. Ví dụ: nếu bạn có thẻ Good To Go! của bạn tại Seattle, WA, Hoa Kỳ, bạn phải trả phí cầu đường thấp hơn so với khi không có thẻ đi xe.

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

Nếu bạn chỉ định phí cầu đường như một phần của 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 giá thẻ và vé cho tuyến đường cho từng thẻ và vé.

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 mức giá ước tính khi phí cầu đường được sử dụ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ả lại dựa trên mức giá của loại xe và vé đã chỉ định. Nếu chỉ định nhiều thẻ, thì giá thấp nhất sẽ được trả về.

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",
  "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 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. Thiết lập trường routes.travelAdvisory.tollInfo để trả về thông tin cho toàn bộ tuyến đường và routes.legs.travelAdvisory.tollInfo để trả về thông tin cho từng tuyến.

{
  "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 tuyến đường có phí ước tính khi phí cầu đường được sử dụng.

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

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",
"routingPreference": "TRAFFIC_AWARE"
}'
-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 về phí cầu đường ma trận

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í thu phí được hỗ trợ

Hiện tại, bạn có thể sử dụng thông tin phí cầu đường cho các vị trí 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	Thành phố Mexico
Hoa Kỳ	Hoa Kỳ	Alabama
Hoa Kỳ	Hoa Kỳ	Alaska
Hoa Kỳ	Hoa Kỳ	California
Hoa Kỳ	Hoa Kỳ	Colorado
Hoa Kỳ	Hoa Kỳ	Delaware
Hoa Kỳ	Hoa Kỳ	Florida
Hoa Kỳ	Hoa Kỳ	Illinois
Hoa Kỳ	Hoa Kỳ	Iowa
Hoa Kỳ	Hoa Kỳ	Indiana
Hoa Kỳ	Hoa Kỳ	Kansas
Hoa Kỳ	Hoa Kỳ	Louisiana
Hoa Kỳ	Hoa Kỳ	Maine
Hoa Kỳ	Hoa Kỳ	Maryland
Hoa Kỳ	Hoa Kỳ	Massachusetts
Hoa Kỳ	Hoa Kỳ	Michigan
Hoa Kỳ	Hoa Kỳ	Minnesota
Hoa Kỳ	Hoa Kỳ	Missouri
Hoa Kỳ	Hoa Kỳ	New Hampshire
Hoa Kỳ	Hoa Kỳ	New Jersey
Hoa Kỳ	Hoa Kỳ	New York
Hoa Kỳ	Hoa Kỳ	North Carolina
Hoa Kỳ	Hoa Kỳ	Ohio
Hoa Kỳ	Hoa Kỳ	Pennsylvania
Hoa Kỳ	Hoa Kỳ	Rhode Island
Hoa Kỳ	Hoa Kỳ	Nam Carolina
Hoa Kỳ	Hoa Kỳ	Texas
Hoa Kỳ	Hoa Kỳ	Utah
Hoa Kỳ	Hoa Kỳ	Virginia
Hoa Kỳ	Hoa Kỳ	Washington
Hoa Kỳ	Hoa Kỳ	West Virginia

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