Rota için geçiş ücretlerini hesaplayın

Bir rotayı ya da rota matrisini hesaplarken rotadaki geçiş ücretlerini hesaba katmak isteyebilirsiniz. Belirli şehirler için tahmini bir rota için uygun para biriminde geçiş ücreti.

Rota matrisindeki ücretli geçişleri görmek için bkz. Rota matrisi için ücretli geçiş ücretlerini hesaplayın.

Desteklenen ücretli geçiş konumlarının listesi için şu referansa bakın: TollPass.

Ücretli geçişler nasıl hesaplanır?

Routes API, tahmini geçiş ücretini hesaplar tüm geçiş fiyat indirimleri veya kartlar göz önünde bulundurularak sürücüye veya araca ve en uygun ödeme yöntemlerini ekleyebilirsiniz. Belirli bir rota için ücretli geçiş ücreti yoksa Routes API'de ücretli geçiş olduğu belirtilir ücreti bilinmiyor.

Doğru ücret tahminleri almak için aşağıdaki bilgileri eklediğinizden emin olun talebinizde:

  • Rota için kullanılan aracın emisyon türü (VehicleEmissionType). Emisyon türü belirtilmemişse benzin yakıtlı bir aracın ücreti: geri döndü.
  • Araç ve sürücünün kullandığı tüm ücretli geçişler (TollPass). API, Gişe geçiş ücretlerini doğru şekilde belirlemek için geçiş pasoları kullanılır ve nakit fiyatlar iade edilir istekteki ücretli geçişler rota için yerel olmadığında.
  • Gerekiyorsa ücretli geçişleri kullanmayacağınızı belirtin. Aşağıdaki yerlerde paralı yollardan kaçınmak istiyorsanız avoidTolls, RouteModifier olarak ekleyin.

Geçiş kartı kullanarak ücretli geçişleri hesaplama

Paralı geçiş kartını kullanarak ücretli geçişleri hesaplamak için geçiş kartı talep ediyor. Ardından API, kart fiyatlarını döndürür.

  • Geçersiz bir geçiş kartı belirtirseniz geçiş kartı yoksayılır.

  • Dizi olarak birden fazla geçiş ücreti belirtilirse API, her bir geçiş için rotanın fiyatını hesaplamak.

Ücretli geçiş kartlarının davranışı bölgeye göre değişiklik gösterebilir.

  • Ücretli geçiş ile ücretler daha düşük olabilir: Bazı bölgelerde sürücü veya araç geçiş kartı olmayanlara göre farklı bir ücret ödenir. Örneğin, Tebrikler! ABD'de, Seattle, WA, ABD'de geçiş ücreti ödeyecekseniz, pas kullanabilir.

  • Bazı yollar için ücretli geçiş gerekebilir: Endonezya gibi bazı bölgelerde paralı geçiş gerektiren yollar için kullanılır. Bir otoyol için geçiş kartı belirtmezseniz paralı geçiş kartının gerekli olduğu bir yol kullanıyorsanız API, ücretli geçiş ücreti döndürmez.

Rota için geçiş ücretlerini hesaplama

Aşağıdaki örnekte computeRoutes tahmini bir ücretle geçiş ücretlerini döndürme yöntemi ücretli geçiş kartı kullanıldığında geçerli olan fiyatı belirtir. Bu örnekte:

  • Hesaplamayı etkinleştirmek için extraComputations dizi alanını TOLLS olarak ayarlayın görebilirsiniz.

  • Araç türünü ve geçiş ücreti türünü belirtmek için routeModifiers alanına girilmelidir. İade edilen ücretli ücret şu tarihlere göre belirlenir: belirtilen araç türü ve kart tarafından kullanılan fiyatlandırma Birden fazla belirtildiğinde en ucuz fiyatlandırma döndürülür.

  • Yöntemi aşağıdaki gibi yapılandırmak için yanıt alanı maskesini kullanın: yanıtta geçiş ücreti bilgilerini verin. Bu örnekte, , aşağıdaki özellikleri yanıt alanı maskesine ekledi:

    • routes.travelAdvisory.tollInfo alanı sahip olabilir.

    • Bilgileri döndürmek için routes.legs.travelAdvisory.tollInfo her bacak için.

Ücretli geçiş bilgisi isteği

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'

Ücretli geçiş bilgilerini içeren yanıt

Yanıtta, TollInfo (REST) veya TollInfo (gRPC) nesnesidir. Burada Örneğin, tüm rota ve ayağının her ayağı için ücret bilgilerine dönersiniz. yol gösterir.

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