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

Bir rota veya rota matrisi hesaplarken rotadaki tüm ücretleri hesaba katmak isteyebilirsiniz. Belirli şehirlerde, bir rotanın tahmini otoyol ücretini uygun para biriminde hesaplayabilirsiniz.

Bir rota matrisi için geçiş ücretlerini almak 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.

Otoyol ücretleri 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 mevcut bir ücretli yol fiyatı yoksa Routes API, bilinmeyen ücrete sahip bir ücretli yol olduğunu belirtir.

Doğru ücret 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). Eğer emisyon türü sağlanmazsa benzinli bir araç için geçiş ücreti döndürülür.
• Aracın ve sürücünün sahip olduğu tüm otoyol geçiş kartları (TollPass) kullanılarak. API, doğru otoyol ücretlerini belirlemek için otoyol geçiş kartlarını kullanır ve istekteki otoyol geçiş kartları rotaya özgü olmadığında nakit fiyatları döndürür.
• Gerekirse ücretli geçiş kullanmayı belirtin. Mümkün olduğunda paralı yollardan kaçınmak istiyorsanız avoidTolls öğesini RouteModifier olarak ekleyin.

Geçiş ücretlerini hesaplamak için geçiş kartı kullanma

Otoyol geçiş ücretlerini otoyol geçiş kartı kullanarak hesaplamak için istek kapsamında otoyol geçiş kartlarını belirtirsiniz. Ardından API, geçiş ücretlerini döndürür.

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

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

Otoyol geçiş kartlarının işleyiş şekli 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, ABD'nin Washington eyaletinin Seattle şehrinde Good To Go! ücretli geçiş kartınız varsa kartınız yoksa ödeyeceğiniz ücretten daha düşük bir ücret ödersiniz.

• Bazı yollar için geçiş ücreti ödemeniz gerekebilir: Endonezya gibi bazı bölgelerde geçiş ücreti ödemeniz gereken yollar vardır. Otoyol geçiş ücreti gerektiren bir rota için otoyol geçiş ücreti belirtmezseniz API, otoyol geçiş ücretini döndürmez.

Bir rotanın otoyol ücretlerini hesaplama

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

• Yanıtta ücret 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ı kullanır.

  • routes.legs.travelAdvisory.tollInfo parametresini kullanarak her bir aşamanın bilgilerini döndürebilirsiniz.

Otoyol ücreti bilgileri isteğinde bulunma

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, rotanın tamamı ve her bir bölümü 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
            }
          ]
        }
      }
    }
  ]
}