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

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

Rota matrisi için ücretli geçişleri öğrenmek üzere Rota matrisi için ücretli geçiş ücretlerini hesaplama bölümüne bakın.

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

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

Routes API, sürücüye veya araca sunulan ücretli geçiş indirimlerini veya geçişlerini ve en uygun ödeme yöntemlerini dikkate alarak tahmini ücret ücretini hesaplar. Belirli bir rota için ücretli ücret yoksa Routes API, bilinmeyen bir ücretli ücretli geçiş bulunduğunu belirtir.

Geçiş ücretleriyle ilgili doğru tahminler almak için isteğinize aşağıdaki bilgileri eklediğinizden emin olun:

  • Rota için kullanılan aracın emisyon türü (VehicleEmissionType). Emisyon türü belirtilmemişse benzinle çalışan araçların ücreti iade edilir.
  • (TollPass) kullanarak araç ve sürücünün kullandığı tüm geçiş ücretleri. API, doğru geçiş ücretlerini belirlemek için ücretli geçiş ücretlerini kullanır ve istekteki geçiş ücreti rota için yerel olmadığında nakit fiyatları döndürür.
  • Gerekirse ücretli geçişleri kullanmamayı belirtin. Mümkünse paralı yollardan kaçınmak isterseniz avoidTolls öğesini RouteModifier olarak ekleyin.

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

Ücretli geçiş kartını kullanarak ücretli geçişleri hesaplamak için istek kapsamında ücretli geçiş kartlarını belirtirsiniz. API, daha sonra kart fiyatlarını döndürür.

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

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

Paralı geçiş kartlarının davranışı bölgeye göre değişebilir.

  • Ücretli geçiş kartında ücretler daha düşük olabilir: Bazı bölgelerde, ücretli geçiş kartı olan bir sürücü veya araç, kartı olmayanlardan farklı bir ücret öder. Örneğin, ABD'nin Seattle, WA, şehrinde Good To Go! geçiş kartınız varsa, pasonuz olmayanlara göre daha düşük bir ücret ödersiniz.

  • Bazı yollar için paralı geçiş gerekebilir: Endonezya gibi bazı bölgelerde ücretli geçiş gerektiren yollar bulunur. Ücretli geçişin gerekli olduğu bir rota için ücretli geçiş belirtmezseniz API, ücretli geçiş ücretini döndürmez.

Rota için ücretli geçiş ücretlerini hesaplama

Aşağıdaki örnekte, geçiş kartı kullanıldığında tahmini bir fiyatla birlikte ücret bilgisi 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 geçiş ücreti türünü belirtin. Döndürülen ücretli geçiş ücreti, belirtilen araç türü ve kartı tarafından kullanılan fiyatlandırmaya göre belirlenir. Birden fazla geçiş belirtilirse en ucuz fiyat döndürülür.

  • Yanıtta ücretli geçiş 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 içeriyordu:

    • 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'

Ücret bilgisi içeren yanıt

Yanıt, TollInfo (REST) veya TollInfo (gRPC) nesnesindeki ücretli geçişlerle ilgili bilgileri içerir. Bu örnekte, tüm rota ve rotanın her bir ayağı için ücretli geçiş 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
            }
          ]
        }
      }
    }
  ]
}