Bir rotayı ya da rota matrisini hesaplarken rotadaki geçiş ücretlerini 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 ücretli geçiş konumlarının listesi için şu referansa bakın: TollPass.
Ücretli geçişler nasıl hesaplanır?
Routes API, tahmini geçiş ücretini hesaplar tüm geçiş fiyat indirimleri veya kartlar göz önünde bulundurularak sürücüye veya araca ve en uygun ödeme yöntemlerini ekleyebilirsiniz. Belirli bir rota için ücretli geçiş ücreti yoksa Routes API'de ücretli geçiş olduğu belirtilir ücreti bilinmiyor.
Doğru ücret tahminleri almak için aşağıdaki bilgileri eklediğinizden emin olun talebinizde:
- Rota için kullanılan aracın emisyon türü
(
VehicleEmissionType
). Emisyon türü belirtilmemişse benzin yakıtlı bir aracın ücreti: geri döndü. - Araç ve sürücünün kullandığı tüm ücretli geçişler
(
TollPass
). API, Gişe geçiş ücretlerini doğru şekilde belirlemek için geçiş pasoları kullanılır ve nakit fiyatlar iade edilir istekteki ücretli geçişler rota için yerel olmadığında. - Gerekiyorsa ücretli geçişleri kullanmayacağınızı belirtin. Aşağıdaki yerlerde paralı yollardan kaçınmak istiyorsanız
avoidTolls
,RouteModifier
olarak ekleyin.
Geçiş kartı kullanarak ücretli geçişleri hesaplama
Paralı geçiş kartını kullanarak ücretli geçişleri hesaplamak için geçiş kartı talep ediyor. Ardından API, kart fiyatlarını döndürür.
Geçersiz bir geçiş kartı belirtirseniz geçiş kartı yoksayılır.
Dizi olarak birden fazla geçiş ücreti belirtilirse API, her bir geçiş için rotanın fiyatını hesaplamak.
Ücretli geçiş kartlarının davranışı bölgeye göre değişiklik gösterebilir.
Ücretli geçiş ile ücretler daha düşük olabilir: Bazı bölgelerde sürücü veya araç geçiş kartı olmayanlara göre farklı bir ücret ödenir. Örneğin, Tebrikler! ABD'de, Seattle, WA, ABD'de geçiş ücreti ödeyecekseniz, pas kullanabilir.
Bazı yollar için ücretli geçiş gerekebilir: Endonezya gibi bazı bölgelerde paralı geçiş gerektiren yollar için kullanılır. Bir otoyol için geçiş kartı belirtmezseniz 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 geçiş ücretlerini 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.Araç türünü ve geçiş ücreti türünü belirtmek için
routeModifiers
alanına girilmelidir. İade edilen ücretli ücret şu tarihlere göre belirlenir: belirtilen araç türü ve kart tarafından kullanılan fiyatlandırma Birden fazla belirtildiğinde en ucuz fiyatlandırma döndürülür.Yöntemi aşağıdaki gibi yapılandırmak için yanıt alanı maskesini kullanın: yanıtta geçiş ücreti bilgilerini verin. Bu örnekte, , aşağıdaki özellikleri yanıt alanı maskesine ekledi:
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ıtta, TollInfo (REST) veya TollInfo (gRPC) nesnesidir. 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 } ] } } } ] }