เมื่อคุณคำนวณเส้นทางหรือเมทริกซ์เส้นทาง คุณอาจต้องพิจารณาค่าผ่านทางสำหรับเส้นทางนั้นๆ สำหรับบางเมือง คุณสามารถคำนวณค่าธรรมเนียม ค่าผ่านทางโดยประมาณสำหรับเส้นทางในสกุลเงินที่เหมาะสม
หากต้องการดูค่าผ่านทางสำหรับเมทริกซ์เส้นทาง โปรดดูคำนวณค่าธรรมเนียมค่าผ่านทางสำหรับเมทริกซ์เส้นทาง
ดูรายการสถานที่เก็บค่าผ่านทางที่รองรับในข้อมูลอ้างอิงของ TollPass
วิธีคำนวณค่าผ่านทาง
Routes API จะคำนวณค่าธรรมเนียมทางค่าผ่านทางโดยประมาณ โดยพิจารณาส่วนลดหรือบัตรผ่านค่าผ่านทางสำหรับคนขับหรือยานพาหนะ รวมถึงวิธีการชำระเงินที่สะดวกที่สุด หากไม่มีค่าผ่านทางสำหรับเส้นทางหนึ่ง Routes API จะระบุค่าผ่านทางที่มีค่าธรรมเนียมที่ไม่รู้จัก
โปรดใส่ข้อมูลต่อไปนี้ในคำขอเพื่อคำนวณค่าผ่านทางโดยประมาณที่ถูกต้อง
- ประเภทการปล่อยก๊าซของยานพาหนะที่ใช้สำหรับเส้นทาง
(
VehicleEmissionType
) หากไม่มีการระบุประเภทการปล่อยก๊าซ ระบบจะต้องคืนค่าผ่านทางสำหรับยานพาหนะที่ใช้น้ำมันเบนซิน - บัตรผ่านทางทั้งหมดของยานพาหนะและคนขับมีโดยใช้ (
TollPass
) API จะใช้บัตรผ่านทางเพื่อกำหนดค่าธรรมเนียมทางพิเศษที่ถูกต้อง และส่งราคาเงินสดเมื่อบัตรผ่านทางในคำขอไม่ได้อยู่ในพื้นที่ของเส้นทาง - ระบุค่าผ่านทางที่เลี่ยงได้ หากจำเป็น หากต้องการเลี่ยงถนนที่เรียกเก็บค่าผ่านทาง ให้เพิ่ม
avoidTolls
เป็นRouteModifier
คำนวณค่าผ่านทางโดยใช้บัตรผ่านทาง
หากต้องการคำนวณค่าผ่านทางโดยใช้บัตรผ่านทาง ให้ระบุบัตรผ่านทางเป็นส่วนหนึ่งของคำขอ จากนั้น API จะแสดงราคาบัตร
หากคุณระบุบัตรผ่านทางที่ไม่ถูกต้อง ระบบจะไม่สนใจบัตร
หากระบุบัตรผ่านทางหลายใบเป็นอาร์เรย์ API จะพยายามคำนวณราคาสำหรับเส้นทางของบัตรผ่านแต่ละรายการ
ลักษณะการทำงานของบัตรผ่านทางอาจแตกต่างกันไปตามภูมิภาค
ค่าผ่านทางอาจต่ำกว่า: ในบางภูมิภาค คนขับหรือยานพาหนะที่มีบัตรผ่านทางจะจ่ายค่าผ่านทางแตกต่างจากผู้ที่ไม่มีบัตรผ่าน ตัวอย่างเช่น ถ้าคุณมีบัตรผ่านทาง Good To Go! ในซีแอตเทิล วอชิงตัน สหรัฐอเมริกา คุณจะต้องจ่ายค่าผ่านทางต่ำกว่ากรณีที่คุณไม่มีบัตร
ถนนบางเส้นอาจต้องใช้ทางพิเศษ: บางภูมิภาค เช่น อินโดนีเซีย มีถนนที่ต้องมีการผ่านทางพิเศษ หากคุณไม่ระบุบัตรผ่านทางสำหรับเส้นทางที่กำหนดให้ต้องใช้บัตรผ่านทาง API จะไม่แสดงค่าผ่านทาง
คำนวณค่าผ่านทางสำหรับเส้นทาง
ตัวอย่างต่อไปนี้ใช้วิธีการ computeRoutes
เพื่อแสดงข้อมูลค่าผ่านทางพร้อมราคาโดยประมาณเมื่อใช้บัตรผ่านทาง ในตัวอย่างนี้ คุณจะ
ตั้งค่าช่องอาร์เรย์
extraComputations
เป็นTOLLS
เพื่อเปิดใช้การคำนวณข้อมูลค่าผ่านทางระบุประเภทยานพาหนะและประเภทบัตรผ่านทางโดยใช้ช่อง
routeModifiers
ของคำขอ ราคาค่าผ่านทางคืนจะอิงตามราคาที่ประเภทยานพาหนะและบัตรผ่านที่ระบุใช้ หากระบุบัตรมากกว่า 1 ใบ ระบบจะแสดงผลราคาที่ต่ำที่สุดใช้มาสก์ช่องการตอบกลับเพื่อกำหนดค่าวิธีแสดงข้อมูลค่าผ่านทางในการตอบกลับ ในตัวอย่างนี้ คำขอมีพร็อพเพอร์ตี้ต่อไปนี้ในมาสก์ของช่องการตอบสนอง
routes.travelAdvisory.tollInfo
เพื่อแสดงผลข้อมูลทั้งเส้นทางroutes.legs.travelAdvisory.tollInfo
เพื่อแสดงข้อมูล สำหรับขาแต่ละข้าง
ขอข้อมูลค่าผ่านทาง
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'
คำตอบที่มีข้อมูลค่าผ่านทาง
การตอบสนองมีข้อมูลเกี่ยวกับค่าผ่านทางในออบเจ็กต์ TollInfo (REST) หรือ TollInfo (gRPC) ในตัวอย่างนี้ คุณจะส่งคืนข้อมูลค่าผ่านทางสำหรับทั้งเส้นทางและในแต่ละขาของเส้นทาง
{ "routes": [ { "legs": [ { "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ], "distanceMeters": 150338, "duration": "6650s", "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ] }