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

Bir rota veya rota matrisi hesaplarken rotadaki tüm ücretleri hesaba katmak isteyebilirsiniz. Belirli şehirlerde, bir rotanın tahmini otoyol ücretini uygun para biriminde hesaplayabilirsiniz.

Bir rota matrisi için geçiş ücretlerini almak istiyorsanız Rota matrisi için geçiş ücretlerini hesaplama başlıklı makaleyi inceleyin.

Desteklenen otoyol geçişi konumlarının listesi için TollPass referansına bakın.

Otoyol ücretleri nasıl hesaplanır?

Routes API, sürücüye veya araca sunulan tüm ücret indirimlerini ya da geçiş kartlarını ve en uygun ödeme yöntemlerini dikkate alarak tahmini ücreti hesaplar. Belirli bir rota için mevcut bir ücretli yol fiyatı yoksa Routes API, bilinmeyen ücrete sahip bir ücretli yol olduğunu belirtir.

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

  • Rota için kullanılan aracın emisyon türü (VehicleEmissionType). Eğer emisyon türü sağlanmazsa benzinli bir araç için geçiş ücreti döndürülür.
  • Aracın ve sürücünün sahip olduğu tüm otoyol geçiş kartları (TollPass) kullanılarak. API, doğru otoyol ücretlerini belirlemek için otoyol geçiş kartlarını kullanır ve istekteki otoyol geçiş kartları rotaya ait değilse nakit fiyatları döndürür.
  • Gerekirse ücretli geçiş kullanmayı belirtin. Mümkün olduğunda ücretli yolları kullanmak istemiyorsanız avoidTolls öğesini RouteModifier olarak ekleyin.

Geçiş ücretlerini hesaplamak için geçiş kartı kullanma

Geçiş ücretlerini hesaplamak için geçiş ücreti kartlarını istek kapsamında belirtirsiniz. Ardından API, geçiş ücretlerini döndürür.

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

  • Birden fazla otoyol geçişini dizi olarak belirtirseniz API, her geçiş için rotanın fiyatını hesaplamaya çalışır.

Otoyol geçiş kartlarının işleyiş şekli bölgeye göre değişiklik gösterebilir.

  • Paralı geçiş kartı olan sürücüler daha düşük ücret öder: Bazı bölgelerde, paralı geçiş kartı olan sürücüler veya araçlar, kart sahibi olmayanlara göre farklı ücret öder. Örneğin, ABD, Washington, Seattle'da Good To Go! ücretli geçiş kartınız varsa kartınız yoksa ödeyeceğiniz ücretten daha düşük bir ücret ödersiniz.

  • Bazı yollar için geçiş ücreti ödemeniz gerekebilir: Endonezya gibi bazı bölgelerde geçiş ücreti ödemeniz gereken yollar vardır. Otoyol geçiş ücreti gerektiren bir rota için otoyol geçiş ücreti belirtmezseniz API, otoyol geçiş ücretini döndürmez.

Bir rotanın otoyol ücretlerini hesaplama

Aşağıdaki örnekte, otoyol geçişi kullanıldığında otoyol ücreti bilgilerini tahmini fiyatla döndürmek için computeRoutes yöntemi kullanılmaktadır. Bu örnekte:

  • Geçiş ücreti bilgilerinin hesaplanmasını etkinleştirmek için extraComputations dizi alanını TOLLS olarak ayarlayın.

  • İsteğin routeModifiers alanını kullanarak araç türünü ve otoyol geçiş türünü belirtin. Döndürülen geçiş ücreti, belirtilen araç türü ve geçiş tarafından kullanılan fiyatlandırmaya dayanır. Birden fazla geçiş belirtilirse en ucuz fiyat döndürülür.

  • Yanıtta ücret bilgilerini döndürecek yöntemi yapılandırmak için yanıt alanı maskesini kullanın. Bu örnekte istek, yanıt alanı maskesine aşağıdaki özellikleri dahil etmiştir:

    • routes.travelAdvisory.tollInfo alanını kullanarak rotanın tamamıyla ilgili bilgileri döndürebilirsiniz.

    • routes.legs.travelAdvisory.tollInfo parametresini kullanarak her bir aşamanın bilgilerini döndürebilirsiniz.

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'

Geçiş ücreti bilgilerini içeren yanıt

Yanıt, TollInfo (REST) veya TollInfo (gRPC) nesnesinde geçiş ücretleriyle ilgili bilgileri içerir. Bu örnekte, rotanın tamamı ve her bir bölümü için 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
            }
          ]
        }
      }
    }
  ]
}