เมื่อคำนวณเส้นทางหรือเมทริกซ์เส้นทาง คุณอาจต้องพิจารณาค่าผ่านทาง สำหรับบางเมือง คุณสามารถคำนวณค่าธรรมเนียมค่าผ่านทางโดยประมาณสำหรับเส้นทางในสกุลเงินที่เหมาะสม
หากต้องการทราบค่าผ่านทางสำหรับเมทริกซ์เส้นทาง โปรดดูคำนวณค่าผ่านทางสำหรับเมทริกซ์เส้นทาง
โปรดดูรายชื่อสถานที่เก็บค่าผ่านทางที่รองรับได้จากข้อมูลอ้างอิงของ 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
}
]
}
}
}
]
}