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

Avrupa Ekonomik Alanı (AEA) geliştiricileri

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 ücreti 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 Routes API, 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 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ş cihazı kullanarak geçiş ücretlerini hesaplamak için, istek kapsamında tüm ücretli geçiş cihazlarını belirtirsiniz. API daha sonra kart fiyatlarını döndürür.

  • Geçersiz bir geçiş cihazı belirtirseniz bu cihaz 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ş ücreti 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ınızın olmadığı duruma 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 ücretli 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 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 ile her bir ayak için bilgileri döndürün.

Ü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'

Geçiş ücreti bilgilerini içeren yanıt

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