Geçiş ücretlerini hesaplayın

Avrupa Ekonomik Alanı (AEA) geliştiricileri

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

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ş kartlarını ve en uygun ödeme yöntemlerini dikkate alarak tahmini paralı yol ücretini hesaplar. Belirli bir rota için geçiş ücreti yoksa Routes API, 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 geçiş ücreti döndürülür.
  • tollPasses kullanılarak araç ve sürücünün sahip olduğu tüm geçiş ücreti kartları. API, doğru geçiş ücretlerini belirlemek için geçiş kartlarını kullanır ve istekteki geçiş kartları rotaya ait değilse 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 istekte ü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 geçiş ücreti kartını dizi olarak belirtirseniz API, her kart 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.

  • Gişe geçiş kartıyla ücretler daha düşük olabilir: Bazı bölgelerde, gişe geçiş kartı olan sürücüler veya araçlar, kartı olmayanlara göre farklı bir geçiş ücreti öder. Örneğin, Good To Go! rozetiniz varsa Seattle, Washington, ABD'de 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

Bir rotanın geçiş ücretlerini hesaplamak için aşağıdaki adımları uygulayın:

  • extraComputations özelliğini TOLLS olarak ayarlayın.
  • routeModifiers özelliğini kullanarak araç türünü ve geçiş ücreti ödeme cihazı türünü belirtin.
  • Bir rotanın tamamı için geçiş ücretlerini hesaplamak üzere isteğin travelAdvisory özelliğinde fields isteğinde bulunun. route.travelAdvisory.tollInfo bölümünü okuyarak rotanın tamamı için geçiş ücreti bilgilerini görüntüleyin.
  • Bir rotanın her bir ayağının geçiş ücretlerini hesaplamak için isteğin legs özelliğinde fields isteğinde bulunun. Her bir ayağın geçiş ücreti bilgilerini route.legs[i].travelAdvisory.tollInfo okuyarak görüntüleyin.

Örnek

Aşağıdaki örnek istekte, bir rota için geçiş ücretlerinin nasıl isteneceği gösterilmektedir:

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};