Compute Routes สามารถแสดงเส้นทางการขับรถที่เพิ่มประสิทธิภาพให้มีระยะทางสั้นลง เมื่อคุณเปิดใช้เส้นทางที่มีระยะทางสั้นกว่า
เมื่อคุณขอเส้นทางที่สั้นกว่า บริการจะแสดงข้อมูลต่อไปนี้
- เส้นทางเริ่มต้น ซึ่งเป็นเส้นทางที่เพิ่มประสิทธิภาพเพื่อเวลาถึงโดยประมาณเป็นหลัก
- เส้นทางที่สั้นกว่าซึ่งได้รับการเพิ่มประสิทธิภาพเพื่อลดระยะทางในการเดินทางตลอดทั้ง ทริป
การทดสอบ A/B คืออะไรและเหตุใดจึงควรใช้
เส้นทางที่มีระยะทางสั้นกว่าจะเน้นระยะทางมากกว่าความสะดวกสบายในการขับขี่หรือความเร็ว เช่น อาจเลือกใช้ถนนในท้องถิ่นแทนทางหลวง ใช้ถนนลูกรัง หรือตัดผ่านลานจอดรถ แต่จะไม่แสดงการเลี้ยวใดๆ ที่ Google Maps ทราบว่า ผิดกฎหมาย
ขอเส้นทางที่มีระยะทางสั้นกว่า
คำขอของคุณต้องเป็นไปตามเกณฑ์ต่อไปนี้
- ตั้งค่า
travelMode
เป็นDRIVE
,BICYCLE
หรือTWO_WHEELER
- ตั้งค่า
requestedReferenceRoutes
เป็นSHORTER_DISTANCE
- ตั้งค่าฟิลด์มาสก์การตอบกลับเพื่อแสดงพร็อพเพอร์ตี้การตอบกลับที่เชื่อมโยงกับ
เส้นทางที่มีระยะทางสั้นกว่า
routes.routeLabels
: ระบุแต่ละเส้นทางเป็นDEFAULT_ROUTE
SHORTER_DISTANCE
หรือDEFAULT_ROUTE_ALTERNATE
routes.routeToken
: โทเค็นเส้นทางที่คุณส่งไปยัง Navigation SDK เพื่อ เรียกเส้นทางที่กำหนดเอง
- อย่าระบุ
Via
จุดแวะพักกลางทาง - อย่าใส่พารามิเตอร์
optimizeWaypointOrder
- ไม่บังคับ: ตั้งค่าฟิลด์มาสก์การตอบกลับเพื่อแสดงพร็อพเพอร์ตี้ต่อไปนี้
ที่เชื่อมโยงกับทั้งเส้นทางเริ่มต้นและเส้นทางที่สั้นกว่า
routes.distanceMeters
: แสดงผลระยะทางของเส้นทางroutes.duration
: แสดงผลระยะเวลาของเส้นทาง
ดูข้อมูลอ้างอิงได้ที่ ReferenceRoute และ RouteLabel
ตัวอย่างคำขอ: เส้นทางที่มีระยะทางสั้นกว่า
โค้ดต่อไปนี้แสดงคำขอเส้นทางที่มีระยะทางสั้นกว่า ใน ตัวอย่างนี้ คุณใช้มาสก์ของช่องการตอบกลับเพื่อแสดงช่องที่เชื่อมโยงกับทั้ง เส้นทางเริ่มต้นและเส้นทางที่สั้นกว่าด้วยมาสก์ของช่องต่อไปนี้
routes.distanceMeters
routes.duration
curl -X POST -H 'content-type: application/json' -d '{ "origin": { "location": { "latLng": { "latitude": 41.76904801292959, "longitude": -72.67374935684933 } } }, "destination": { "location": { "latLng": { "latitude": 41.823042361105024, "longitude": -71.40933143059424 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE", "requestedReferenceRoutes": ["SHORTER_DISTANCE"], }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY \ -H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
ตัวอย่างคำตอบเส้นทางที่สั้นกว่า
{
"routes": [
{
"distanceMeters": 138943,
"duration": "5373s",
"routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
"routeLabels": [
"DEFAULT_ROUTE"
]
},
{
"distanceMeters": 112610,
"duration": "7165s",
"routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
"routeLabels": [
"SHORTER_DISTANCE"
]
}
]
}
ตัวอย่างคำขอ: เส้นทางที่สั้นกว่าและประหยัดเชื้อเพลิง
โค้ดต่อไปนี้แสดงคำขอทั้งเส้นทางที่สั้นกว่าและเส้นทางที่ประหยัดเชื้อเพลิง
`
curl -X POST -d '{ "origin": { "location": { "latLng": { "latitude": 41.76904801292959, "longitude": -72.67374935684933 } } }, "destination": { "location": { "latLng": { "latitude": 41.823042361105024, "longitude": -71.40933143059424 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL", "requestedReferenceRoutes": ["SHORTER_DISTANCE", "FUEL_EFFICIENT"] }'
-H 'Content-Type: application/json'
-H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken'
'https://routes.googleapis.com/directions/v2:computeRoutes'
ตัวอย่างคำตอบ: ระยะทางสั้นลงและเส้นทางที่ประหยัดเชื้อเพลิง
ในกรณีนี้ ระยะทางที่สั้นกว่าและเส้นทางที่ประหยัดเชื้อเพลิงมากที่สุดคือเส้นทางเดียวกัน ระบบจึงแสดงเส้นทางนั้นและรวม routeLabel
ไว้สำหรับเส้นทางทั้ง 2 ประเภท
{ "routes": [ { "distanceMeters": 138943, "duration": "5375s", "routeToken": "Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 112610, "duration": "7156s", "routeToken": "CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f", "routeLabels": [ "FUEL_EFFICIENT", "SHORTER_DISTANCE" ] } ] }
ภูมิภาคที่รองรับ
เส้นทางที่มีระยะทางสั้นกว่ารองรับในทุกภูมิภาค
การเรียกเก็บเงิน
Google Maps Platform ไม่เรียกเก็บเงินเพิ่มเติมสำหรับการใช้ฟีเจอร์เวอร์ชันทดลอง ระบบจะเรียกเก็บเงินตามการใช้งาน API โดยอิงตามพารามิเตอร์อื่นๆ ที่คุณตั้งค่าไว้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกเก็บเงิน สำหรับ Routes API