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.

Otoyol ücretleri 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). Hiçbir emisyon türü sağlanmazsa benzinli bir araç için geçiş ücreti döndürülür.
  • 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. Mümkün olduğunda ücretli yolları kullanmak istemiyorsanız avoidTolls öğesini 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.

Otoyol ücreti bilgileri isteğinde bulunma

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. Bu örnekte, rotanın tamamı ve her bir bölümü için otoyol geçiş ücreti bilgilerini döndürüyorsunuz.

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