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.

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.

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 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:

Mã vùngQuốc gia/VùngTiể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.