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 paralı yol ücreti yoksa Rotalar API'si, bilinmeyen bir ücretle paralı yolun 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 geçiş ücreti döndürülür.
• Araç ve sürücünün sahip olduğu tüm geçiş ücreti kartları (TollPass) kullanılarak. 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ı seçin. Mümkün olduğunda ücretli yolları kullanmak istemiyorsanız avoidTolls simgesini RouteModifier olarak ekleyin.

Otoyol geçiş kartı kullanarak geçiş ücretlerini hesaplama

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

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

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

Geçiş cihazları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 otoyol geçiş kartınız varsa otoyol geçiş kartınızın olmadığı duruma kıyasla daha düşük bir geçiş ücreti ödersiniz.

• Bazı yollar için ü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 otoyol geçiş kartı belirtmezseniz API, geçiş ücreti fiyatı döndürmez.

Bir rotanın geçiş ücretlerini hesaplama

Aşağıdaki örnekte, otoyol geçiş kartı kullanıldığında tahmini fiyatla birlikte geçiş ücreti 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 otoyol geçiş 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 geçiş 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 tuşuna basın.

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'

Ü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
            }
          ]
        }
      }
    }
  ]
}