Oblicz opłaty za przejazd

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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.

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 regionuKraj/regionDroga/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.