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

Bir rota veya rota matrisini hesaplarken, rota üzerindeki geçiş ücretlerini de hesaba katmak isteyebilirsiniz. Belirli şehirlerde, rotanın tahmini geçiş ücretini ilgili para biriminde hesaplayabilirsiniz.

Bir rota matrisinde geçiş ücretlerini öğrenmek için Rota matrisinde ücret ücretlerini hesaplama bölümüne bakın.

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

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

Routes API, sürücü veya araç için sunulan geçiş ücreti indirimlerini ya da geçiş kartlarını ve en uygun ödeme yöntemlerini dikkate alarak tahmini geçiş ücretini hesaplar. Belirli bir rota için uygun bir ücretli geçiş yoksa Routes API, ücreti bilinmeyen bir ücretli geçiş olduğunu gösterir.

Ücret tahminlerinin doğru olması için isteğinize aşağıdaki bilgileri eklediğinizden emin olun:

• Rotada kullanılan aracın emisyon türü (VehicleEmissionType). Emisyon türü belirtilmemişse benzin yakıtlı bir aracın ücreti iade edilir.
• Aracın ve sürücünün TollPass kullanarak yaptığı tüm geçiş geçişleri (TollPass). API, doğru geçiş ücretlerini belirlemek için ücretli geçiş kartlarını kullanır ve istekteki ücretli geçişler rotada yerel olmadığında nakit fiyatlarını döndürür.
• Gerekiyorsa ücretli geçişleri kullanmayacağınızı belirtin. Mümkün olduğunda paralı yollardan kaçınmak istiyorsanı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 istek kapsamında tüm geçiş geçişlerini belirtirsiniz. 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 belirtirseniz API, her geçiş için rota fiyatını hesaplamaya çalışır.

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

• Ücretli geçişte ücretler daha düşük olabilir: Bazı bölgelerde, geçiş ücreti uygulaması olan bir sürücü veya araç, kartı olmayanlardan farklı bir ücret öder. Örneğin, Seattle, WA, ABD'de Good To Go! geçiriyorsanız geçiş kartınız yoksa daha düşük bir ücret ödersiniz.

• Bazı yollar için ücretli geçiş gerekebilir: Endonezya gibi bazı bölgelerde ücretli geçiş yapılması gereken yollar vardır. Geçiş kartının gerekli olduğu bir rota için geçiş ücreti belirtmezseniz API, ücretli geçiş ücreti döndürmez.

Rota için geçiş ücretlerini hesaplama

Aşağıdaki örnekte, ücretli geçiş kartı kullanıldığında tahmini ücretle birlikte ücretli yol bilgilerini döndürmek için computeRoutes yöntemi kullanılmaktadır. Bu örnekte:

• Ücret 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 ücretli geçiş türünü belirtin. İade edilen ücretli fiyat, belirtilen araç türü ve kartı tarafından kullanılan fiyata göre belirlenir. Birden fazla geçiş belirtilirse en ucuz fiyatlandırma döndürülür.

• Yanıtta ücretli geçiş bilgilerini döndürme yöntemini yapılandırmak için yanıt alanı maskesini kullanın. Bu örnekte, istek, yanıt alanı maskesine aşağıdaki özellikleri dahil etti:

  • routes.travelAdvisory.tollInfo alanını kullanır.

  • her bacakla ilgili bilgileri döndürmek için routes.legs.travelAdvisory.tollInfo.

Ü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) nesnesindeki ücretli ücretlerle ilgili bilgiler yer alır. Bu örnekte, tüm rota ve rotanın her ayağı için ücret bilgisi alırsınız.

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