Ta strona została przetłumaczona przez Cloud Translation API.

Oblicz opłaty za przejazd

Podczas obliczania trasy lub macierzy trasy możesz wziąć pod uwagę wszelkie opłaty drogowe na trasie. W przypadku wybranych miast możesz obliczyć szacunkową opłatę za trasę w odpowiedniej walucie.

Zobacz listę obsługiwanych lokalizacji płatnych poniżej.

Jak obliczamy opłaty za przejazd

Interfejs Routes API oblicza szacowaną opłatę za przejazd, uwzględniając wszelkie rabaty i bilety na przejazdy dostępne dla kierowcy lub pojazdu oraz najwygodniejsze formy płatności. Jeśli na danej trasie nie ma dostępnych opłat drogowych, interfejs API tras Google wskazuje istnienie opłaty za przejazd z nieznaną opłatą.

Aby dokładnie obliczać opłaty za przejazd, interfejs Routes API udostępnia opcję określania:

Typ emisji pojazdu, który został użyty na trasie (VehicleEmissionType). Jeśli nie podasz typu emisji, zwrócimy opłatę za przejazd pojazdem benzynowym.
Wszelkie opłaty drogowe dla kierowcy lub pojazdu, które mogą obowiązywać (TollPass). Jeśli nie określisz żadnej opłaty za przejazd, interfejs API zwróci cenę gotówkową.
avoidTolls jako RouteModifier, aby uniknąć dróg płatnych.

Obliczanie opłat za korzystanie z opłat

W niektórych regionach kierowca lub inny pojazd z bezpłatnym dostępem uiszcza inną opłatę niż osoby, które tego nie zrobiły. Jeśli na przykład masz bilet ważny, znajdujący się w Seattle w Stanach Zjednoczonych, płacisz mniej niż w przypadku braku biletu.

W niektórych regionach, na przykład w Indonezji, znajdują się drogi wymagające biletu. Jeśli przejazd nie jest określony dla trasy, dla której jest wymagany, nie zostanie zwrócona żadna cena.

Jeśli w ramach żądania określisz opłatę, interfejs API spróbuje zwrócić cenę biletu:

Jeśli podasz nieprawidłowy bilet płatny, będzie on ignorowany.
Jako tablicę możesz określić wiele winiet. Interfejs API próbuje obliczyć cenę biletu na każdej trasie.

Obliczanie opłat za przejazd na wybranej trasie

Poniższy przykład pokazuje metodę computeRoutes, która zwraca informacje o cenie za przejazd, używając szacowanej ceny. W tym przykładzie:

Aby włączyć obliczanie informacji o opłatach, ustaw pole tablicy extraComputations na TOLLS.
Określ typ pojazdu i typ opłaty za przejazd, korzystając z pola routeModifiers w żądaniu. Zwrócona kwota jest ustalana na podstawie cen określonych przez konkretny typ pojazdu i bilet. Jeśli określisz więcej niż jeden bilet, wyświetli się najniższa cena.
Użyj maski pola odpowiedzi, aby skonfigurować metodę zwracania w odpowiedzi informacji o wysokości opłaty drogowej. W tym przykładzie żądanie maskowało pole właściwości w ten sposób:
- routes.travelAdvisory.tollInfo, by wyświetlić informacje o całej trasie.
- routes.legs.travelAdvisory.tollInfo, aby zwrócić informacje o każdym oddziale.
Uwaga: ta trasa ma tylko 1 etap.

Prośba o informacje o opłatach

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'

Odpowiedź zawierająca informacje o opłatach

Odpowiedź zawiera informacje o opłatach w obiekcie TollInfo (REST) lub TollInfo (gRPC). W tym przykładzie zwracamy informacje o opłatach na całej trasie i na poszczególnych etapach trasy.

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}

Oblicz opłaty za przejazd w macierzy macierzystej

W przykładzie poniżej wykorzystano metodę computeRouteMatrix, aby zwrócić informacje o wysokości trasy na trasie z szacowaną ceną przy korzystaniu z opłaty za przejazd:

Aby włączyć obliczanie informacji o opłatach, ustaw pole tablicy extraComputations na TOLLS.
Typ pojazdu i typ opłaty drogowej określ w polu routeModifiers punktów trasy origin żądania. Zwracana opłata zależy od cennika określonego pojazdu i biletu. Jeśli określisz więcej niż 1 bilet, zostanie zwrócona najniższa cena.
Użyj maski pola odpowiedzi, aby skonfigurować metodę zwracania w odpowiedzi informacji o wysokości opłaty drogowej. Określ wartość routes.travelAdvisory.tollInfo, aby wyświetlać informacje dotyczące całej trasy.

Prośba o informacje o płatnym macierzy macierzystym trasy

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'

Odpowiedź na informacje dotyczące opłat drogowych w macierzy macierzystej

Odpowiedź zawiera informacje o opłatach w obiektach TollInfo (REST) i TollInfo (gRPC).

Aby skonfigurować metodę zwracania informacji o opłatach, użyj maski pola odpowiedzi do ustawienia pola travelAdvisory.tollInfo w masce.

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

Obsługiwane lokalizacje opłat

Informacje o opłatach są obecnie dostępne dla tych lokalizacji:

Kod regionu	Kraj/region	Droga/stan/miasto/droga płatna
AR	Argentyna	Buenos Aires
AU	Australia	Brisbane
AU	Australia	Sydney
BR	Brazylia	Cały kraj
Identyfikator	Indonezja	Cały kraj
IN	Indie	Cały kraj
MX	Meksyk	Miasto Meksyk
Stany Zjednoczone	Stany Zjednoczone	Alabama
Stany Zjednoczone	Stany Zjednoczone	Alaska,
Stany Zjednoczone	Stany Zjednoczone	Kalifornia
Stany Zjednoczone	Stany Zjednoczone	Kolorado
Stany Zjednoczone	Stany Zjednoczone	Delaware,
Stany Zjednoczone	Stany Zjednoczone	Floryda
Stany Zjednoczone	Stany Zjednoczone	Illinois
Stany Zjednoczone	Stany Zjednoczone	Iowa
Stany Zjednoczone	Stany Zjednoczone	Indiana,
Stany Zjednoczone	Stany Zjednoczone	Kansas,
Stany Zjednoczone	Stany Zjednoczone	Luizjana
Stany Zjednoczone	Stany Zjednoczone	Maine,
Stany Zjednoczone	Stany Zjednoczone	Maryland,
Stany Zjednoczone	Stany Zjednoczone	Massachusetts
Stany Zjednoczone	Stany Zjednoczone	Michigan,
Stany Zjednoczone	Stany Zjednoczone	Minnesota
Stany Zjednoczone	Stany Zjednoczone	Missouri
Stany Zjednoczone	Stany Zjednoczone	New Hampshire,
Stany Zjednoczone	Stany Zjednoczone	New Jersey
Stany Zjednoczone	Stany Zjednoczone	Nowy Jork
Stany Zjednoczone	Stany Zjednoczone	Karolina Północna
Stany Zjednoczone	Stany Zjednoczone	Ohio,
Stany Zjednoczone	Stany Zjednoczone	Pensylwania,
Stany Zjednoczone	Stany Zjednoczone	Rhode Island
Stany Zjednoczone	Stany Zjednoczone	Karolina Południowa
Stany Zjednoczone	Stany Zjednoczone	Teksas
Stany Zjednoczone	Stany Zjednoczone	Utah
Stany Zjednoczone	Stany Zjednoczone	Wirginia
Stany Zjednoczone	Stany Zjednoczone	Waszyngton
Stany Zjednoczone	Stany Zjednoczone	Wirginia Zachodnia,

Te informacje będą aktualizowane w miarę udostępniania danych o opłatach.