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

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

Bir rota matrisiyle ilgili ü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üye veya araca sunulan paralı geçiş ücretlerini 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, ücreti bilinmeyen bir ücretli geçiş bulunduğunu belirtir.

Doğru geçiş tahminleri almak 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 benzinle çalışan bir 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ş ücreti rota için yerel olmadığında nakit fiyatlarını döndürür.
  • Gerekiyorsa ücretli geçiş ücretlerini belirtin. Mümkün olduğunda paralı yollardan kaçınmak isterseniz avoidTolls öğesini RouteModifier olarak ekleyin.

Ücretli geçiş kartı kullanarak 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. Daha sonra API, kart fiyatlarını döndürür.

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

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

Geçiş geçişlerinde kullanılan yöntem bölgeye göre değişebilir.

  • Ücretli geçiş kartı ile ü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, Seattle, WA, ABD'de Gidilecek Geçiş Ücreti için geçiş kartınız varsa, kartınıza sahip olmadığınızda daha düşük bir ücret ödersiniz.

  • Bazı yollarda paralı geçiş kartı gerekebilir: Endonezya gibi bazı bölgelerde, ücretli geçiş gerektiren yollar bulunur. Ücretli geçiş kartının gerekli olduğu bir rota için ücretli geçiş belirtmezseniz API, ücretli geçiş ücretini 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 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önüş ü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.

  • Yöntemi yanıtta ücretli arama bilgilerini döndürecek şekilde yapılandırmak için yanıt alanı maskesini kullanın. Bu örnekteki 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.

Geçiş ücreti 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 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
            }
          ]
        }
      }
    }
  ]
}