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

Bir rota veya rota matrisi hesaplarken rotadaki paralı yol ücretlerini göz önünde bulundurmak isteyebilirsiniz. Belirli şehirlerde, bir rota için tahmini geçiş ücretini uygun para biriminde hesaplayabilirsiniz.

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

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

Geçiş ücretleri nasıl hesaplanır?

Routes API, sürücü veya araç için geçerli olan tüm paralı yol fiyatı indirimlerini ya da geçişlerini ve en uygun ödeme yöntemlerini dikkate alarak tahmini paralı yol ücretini hesaplar. Belirli bir rota için geçiş ücreti yoksa Rotalar API'si, bilinmeyen bir ücretle geçiş ücretinin varlığını belirtir.

Doğru geçiş ücreti 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). Emisyon türü sağlanmazsa benzinle çalışan bir araç için alınan geçiş ücreti döndürülür.
• Araç ve sürücünün kullandığı tüm geçiş ücreti kartları (TollPass). API, doğru geçiş ücretlerini belirlemek için geçiş ücreti kartlarını kullanır ve istekteki geçiş ücreti kartları rotaya yerel olmadığında nakit fiyatları döndürür.
• Gerekirse ücretli geçişleri kullanmamayı belirtin. Mümkün olduğunda ücretli yolları kullanmak istemiyorsanız avoidTolls simgesini RouteModifier olarak ekleyin.

Geçiş ücretlerini geçiş cihazı kullanarak hesaplama

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

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

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

Ücretli geçiş kartlarının işleyiş şekli bölgeye göre değişebilir.

• Ücretler, paralı yol geçiş kartıyla daha düşük olabilir: Bazı bölgelerde, paralı yol geçiş kartı olan sürücüler veya araçlar, kartı olmayanlara göre farklı bir paralı yol ücreti öder. Örneğin, ABD'nin Washington eyaletindeki Seattle şehrinde Good To Go! adlı bir geçiş kartınız varsa geçiş kartı olmayanlara kıyasla daha düşük bir geçiş ücreti ödersiniz.

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

Bir rotanın geçiş ücretlerini hesaplama

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

• Ücretli yol 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 kartı türünü belirtin. Döndürülen geçiş ücreti fiyatı, belirtilen araç türü ve geçiş kartı tarafından kullanılan fiyatlandırmaya dayanır. Birden fazla geçiş belirtilirse en ucuz fiyatlandırma döndürülür.

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

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

  • routes.legs.travelAdvisory.tollInfo her bir ayak için bilgileri döndürmek üzere.

Ü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ıt, TollInfo (REST) veya TollInfo (gRPC) nesnesinde ücretli yollarla ilgili bilgiler içerir. Bu örnekte, tüm rota ve rotanın her ayağı 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
            }
          ]
        }
      }
    }
  ]
}