Bir rotayı veya rota matrisini hesaplarken rotadaki tüm geçiş ücretlerini hesaba katmak isteyebilirsiniz. Belirli şehirlerde, rotanın tahmini geçiş ücretini ilgili para biriminde hesaplayabilirsiniz.
Rota matrisi için ücretli geçişleri almak için Rota matrisi için ücretli geçiş ücretlerini hesaplama bölümünü inceleyin.
Desteklenen ücretli geçiş konumlarının listesi için TollPass referansına bakın.
Ücretli geçişler nasıl hesaplanır?
Routes API, sürücü veya araç için geçerli geçiş ücreti indirimleri ya da biletleri ve en uygun ödeme yöntemlerini göz önünde bulundurarak tahmini geçiş ücretini hesaplar. Belirli bir rota için ücretli ücret yoksa Routes API, bilinmeyen bir ücreti olan bir ücretli geçişin bulunduğunu belirtir.
Geçiş ücreti tahminlerinin doğru olması 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ü belirtilmemişse benzinle çalışan aracın ücreti iade edilir. TollPass
kullanarak araç ve sürücünün kullandığı tüm geçiş ücretleri. API, doğru geçiş ücretlerini belirlemek için geçiş kartlarını kullanır ve istekteki geçiş ücretleri rota için yerel olmadığında nakit fiyatları döndürür.- Gerekirse ücretli geçişleri kullanmamayı belirtin. Mümkünse paralı yollardan kaçınmak istiyorsanız
avoidTolls
değeriniRouteModifier
olarak ekleyin.
Geçiş kartı kullanarak ücretli geçişleri hesaplama
Ücretli geçiş kartı kullanarak ücretli geçişleri hesaplamak için istek kapsamında geçiş ücretlerini belirtirsiniz. Ardından API, geçiş fiyatlarını döndürür.
Geçersiz bir ücretli geçiş kartı belirtirseniz kart yok sayılır.
Bir dizi olarak birden fazla geçiş ücreti belirtirseniz API, her geçiş için rotanın fiyatını hesaplamaya çalışır.
Ücretli geçiş geçişlerinde kullanılan yollar bölgeye göre değişiklik gösterebilir.
Paralı girişle ücretler daha düşük olabilir: Bazı bölgelerde, ücretli geçiş kartı olan sürücü veya araç ile biniş kartı olmayan sürücüler için farklı bir ücret alınır. Örneğin, ABD'nin Seattle, WA, eyaletinde Good To Go! geçiş kartınız varsa, pasonuz olmamasına göre daha düşük bir ücret ödersiniz.
Bazı yollar için paralı geçiş gerekebilir: Endonezya gibi bazı bölgelerde ücretli geçiş gerektiren yollar vardır. Ücretli geçişin gerekli olduğu bir rota için ücretli geçiş belirtmezseniz API, ücretli fiyat döndürmez.
Rota için geçiş ücretlerini hesaplama
Aşağıdaki örnekte, geçiş kartı kullanıldığında tahmini bir fiyatla birlikte ücret bilgisi döndürmek için computeRoutes
yöntemi kullanılmaktadır. Bu örnekte:
Ücret bilgilerinin hesaplanmasını etkinleştirmek için
extraComputations
dizisi alanınıTOLLS
olarak ayarlayın.İsteğin
routeModifiers
alanını kullanarak araç türünü ve geçiş kartı türünü belirtin. Döndürülen ücretli fiyat, belirtilen araç türü ve paso tarafından kullanılan fiyatlandırmaya göre belirlenir. Birden fazla geçiş belirtilirse en ucuz fiyatlandırma döndürülür.Yanıtta ücretli telefon 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ı kullanabilirsiniz.Her bacakla ilgili bilgileri döndürmek için
routes.legs.travelAdvisory.tollInfo
.
Ü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'
Ücret bilgisi içeren yanıt
Yanıt, TollInfo (REST) veya TollInfo (gRPC) nesnesindeki ücretli geçişlerle ilgili bilgileri içerir. Bu örnekte, rotanın tamamı ve rotanın her bir ayağı için ücret bilgilerini döndürmüş olursunuz.
{ "routes": [ { "legs": [ { "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ], "distanceMeters": 150338, "duration": "6650s", "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ] }