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

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

Rota matrisi için ücretli geçişleri almak için Rota matrisi için ücretli geçiş ücretlerini hesaplama bölümünü inceleyin.

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 geçerli geçiş ücreti indirimleri ya da biletleri ve en uygun ödeme yöntemlerini göz önünde bulundurarak tahmini geçiş ücretini hesaplar. Belirli bir rota için ücretli ücret yoksa Routes API, bilinmeyen bir ücreti olan bir ücretli geçişin bulunduğunu belirtir.

Geçiş ücreti tahminlerinin doğru olması 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 aracı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 geçiş kartlarını kullanır ve istekteki geçiş ücretleri 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 istiyorsanız avoidTolls değerini RouteModifier olarak ekleyin.

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

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

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

  • Bir dizi olarak birden fazla geçiş ücreti belirtirseniz API, her geçiş için rotanın fiyatını hesaplamaya çalışır.

Ücretli geçiş geçişlerinde kullanılan yollar bölgeye göre değişiklik gösterebilir.

  • Paralı girişle ücretler daha düşük olabilir: Bazı bölgelerde, ücretli geçiş kartı olan sürücü veya araç ile biniş kartı olmayan sürücüler için farklı bir ücret alınır. Örneğin, ABD'nin Seattle, WA, eyaletinde Good To Go! geçiş kartınız varsa, pasonuz olmamasına 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 vardır. Ücretli geçişin gerekli olduğu bir rota için ücretli geçiş belirtmezseniz API, ücretli fiyat döndürmez.

Rota için 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 dizisi alanını TOLLS olarak ayarlayın.

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

  • Yanıtta ücretli telefon 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ı kullanabilirsiniz.

    • 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, rotanın tamamı ve rotanın her bir ayağı için ücret bilgilerini döndürmüş olursunuz.

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