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

Bir rota veya rota matrisi hesaplarken rotadaki tüm ücretleri hesaba katmak isteyebilirsiniz. Belirli şehirler için tahmini bir rota için uygun para biriminde geçiş ücreti.

Rota matrisindeki ücretli geçişleri görmek için bkz. Rota matrisi için ücretli geçiş ücretlerini hesaplayın.

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

Otoyol ücretleri nasıl hesaplanır?

Routes API, sürücüye veya araca sunulan tüm ücret indirimlerini ya da geçiş kartlarını ve en uygun ödeme yöntemlerini dikkate alarak tahmini ücreti 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). Hiçbir 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 ait değilse nakit fiyatları döndürür.
• Gerekirse ücretli geçişleri kullanmayı belirtin. Mümkün olduğunda ücretli yolları kullanmak istemiyorsanız avoidTolls öğesini RouteModifier olarak ekleyin.

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

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

• Geçersiz bir otoyol geçişi belirtirseniz geçiş 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.

Ücretli geçiş kartlarının davranışı bölgeye göre değişiklik gösterebilir.

• Paralı geçiş kartı olan sürücüler daha düşük ücret öder: Bazı bölgelerde, paralı geçiş kartı olan sürücüler veya araçlar, kart sahibi olmayanlara göre farklı ü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 ücretli geçiş gerekebilir: Endonezya gibi bazı bölgelerde paralı geçiş gerektiren yollar için kullanılır. Bir ücretli geçiş kartı için bir paralı geçiş kartının gerekli olduğu bir yol kullanıyorsanız API, ücretli geçiş ücreti döndürmez.

Rota için geçiş ücretlerini hesaplama

Aşağıdaki örnekte computeRoutes tahmini bir ücretle ücretli geçiş bilgilerini döndürme yöntemi ücretli geçiş kartı kullanıldığında geçerli olan fiyatı belirtir. Bu örnekte:

• Hesaplamayı etkinleştirmek için extraComputations dizi alanını TOLLS olarak ayarlayın görebilirsiniz.

• İsteğin routeModifiers alanını kullanarak araç türünü ve otoyol geçiş türünü belirtin. İade edilen ücretli ücret şu tarihlere göre belirlenir: belirtilen araç türü ve kart tarafından kullanılan fiyatlandırma 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ı sahip olabilir.

  • Bilgileri döndürmek için routes.legs.travelAdvisory.tollInfo her bacak için.

Ü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 geçiş ücretleriyle ilgili bilgileri içerir. Burada Örneğin, tüm rota ve ayağının her ayağı için ücret bilgilerine dönersiniz. yol gösterir.

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