การเพิ่มประสิทธิภาพจุดอ้างอิงเป็นฟีเจอร์ "เส้นทางที่ต้องการ" ที่ขยายการใช้งานร่วมกับ ComputeRoutes
เพิ่มประสิทธิภาพลำดับจุดอ้างอิงกลางในเส้นทางของผู้เดินทาง เพื่อให้มั่นใจว่าผู้เดินทางจะใช้เส้นทางที่มีประสิทธิภาพสูงสุด ComputeRoutes
การใช้งานการเพิ่มประสิทธิภาพจุดอ้างอิงรองรับโหมดการเดินทางต่อไปนี้
- รถ
- มอเตอร์ไซค์
- ปั่นจักรยาน
- เดินเท้า
เหตุใดจึงควรใช้การเพิ่มประสิทธิภาพจุดอ้างอิง
เมื่อสร้างแอปที่นำทางผู้ใช้ผ่านจุดอ้างอิงต่างๆ ในเส้นทางไปยังจุดหมาย สิ่งสำคัญที่ควรเดินทางคือคนเดินทางข้ามจุดอ้างอิงตามลำดับที่เหมาะสมที่สุด ซึ่งช่วยให้มั่นใจได้ว่าผู้เดินทางจะไปถึงทุกจุดของทางภายในระยะเวลาที่สั้นที่สุด
วิธีการทำงาน
โดยค่าเริ่มต้น ComputeRoutes
จะคำนวณเส้นทางผ่านจุดอ้างอิงของตนตามลำดับที่ระบุในตอนแรก คุณสามารถใช้ ComputeRoutes
เพื่อเพิ่มประสิทธิภาพเส้นทางโดยการจัดเรียงจุดอ้างอิงตรงกลางใหม่ให้อยู่ในลำดับที่มีประสิทธิภาพมากขึ้น
คุณจะได้รับเส้นทางที่มีจุดอ้างอิงที่เพิ่มประสิทธิภาพแล้ว หากตั้งค่าช่อง optimizeWaypointOrder
ในเนื้อหาคำขอเป็น true
หมายเหตุ: การคำนวณการเพิ่มประสิทธิภาพจุดอ้างอิงจะขึ้นอยู่กับเวลาเดินทางเป็นหลัก แต่ฟีเจอร์นี้ยังพิจารณาปัจจัยอื่นๆ ด้วย เช่น ระยะทางและจำนวนครั้งที่เลี้ยว
รับจุดอ้างอิงที่เรียงลำดับใหม่
หากต้องการรับเส้นทางที่มีจุดอ้างอิงที่เรียงลำดับใหม่ ให้ตั้งค่าช่องบูลีน optimizeWaypointOrder
เป็น true
ในส่วนเนื้อหาของคำขอเป็น ComputeRoutes
และใส่ฟิลด์ optimizedIntermediateWaypointIndex
ในมาสก์ของช่องด้วย เนื้อหาการตอบกลับมีลำดับของการชี้ทางที่เพิ่มประสิทธิภาพในช่อง optimizedIntermediateWaypointIndex
หมายเหตุ: ช่อง optimizedIntermediateWaypointIndex
จะแสดงผลค่าที่เป็น 0
ตัวอย่างคำขอ
ตัวอย่างคำขอต่อไปนี้ระบุเส้นทางที่ใกล้กับวิทยาเขตของมหาวิทยาลัยสแตนฟอร์ด มีการระบุจุดอ้างอิงของเส้นทางตามลำดับในคำขอ คำขอมีต้นทางและปลายทาง โดยมีจุดอ้างอิงตรงกลาง 2 จุด
POST /v1alpha:computeRoutes
Host: routespreferred.googleapis.com
Content-Type: application/json
X-Server-Timeout: 10
X-Goog-Api-Key: YOUR_API_KEY
X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
{
"origin":{
"location":{
"latLng":{
"latitude": 37.418956,
"longitude": -122.160815
}
}
},
"intermediates": [
{
"location":{
"latLng":{
"latitude": 37.4176423,
"longitude":-122.1102246
}
}
},
{
"location":{
"latLng":{
"latitude": 37.407689,
"longitude": -122.1360597
}
}
}
],
"destination":{
"location":{
"latLng":{
"latitude": 37.4032137,
"longitude": -122.0349119
}
}
},
"travelMode": "DRIVE",
"optimizeWaypointOrder": true,
"routingPreference": "TRAFFIC_AWARE"}
ตัวอย่างการตอบกลับ
คุณจะเห็นดัชนีจุดอ้างอิงกลางที่เรียงลำดับใหม่ในช่อง optimizedIntermediateWaypointIndex
ภายในออบเจ็กต์เส้นทางในเนื้อหาการตอบกลับ โพลีไลน์ที่เข้ารหัสจะเหมือนกับใน Directions API และ ComputeRoutes
routes {
distance_meters: 17647
duration {
seconds: 1866
}
polyline {
encoded_polyline: "wkkcFvorhVU{@Ec@C}CG}@Mm@[}@i@y@[[g@_@Tk@BSjCgGfF|D\\Pv@Lj@@XaCTeC\\aCTs@`ByD`@k@h@e@x@Yh@GtADhBF|@G`AWpAs@lAsAdA{A`BmDr@cBmUqQoS}OyGmFiBsAgEwD}CaCU_@Og@@e@Hy@nGkO~@sBr@cBlDqIlByEp@}AjIfGnBbBHLLd@^p@~ErDfNrKrA~@DIhEeBTQ~AqDlE{KjBgE|FnEh@aAi@`A}FoE~AmD`A}BcAm@mHwFwD}CkLwIsDqCgF_EG[GKnCsDrA_BrC_CnCoBpEkD`EyClCsBcBeBIAkGkH]k@eJmKQKsAuA_@g@wCoDGQmEmFmIqROKaDuHvBkBxAgANCRH^f@v@dBHDD?`AUiBqEhBpEaATMCQYm@wAY]SIOByAfAwBjB_ByDaAwBiCeIA[c@aBqEuNOm@IQbA{c@p@aZFmCTuBLg@Tc@BUAKxOeV~Vy_@nBoDv@_BvAcDzA_EdG{RdC{HtIsY|B{Hx@mDbAuFdBsMbKsv@TaBf@}AdF{Sn@_DJq@Lo@aE`@]GUQmAmAQk@@g@RK`Ce@d@UDEPc@f@cCrAyGJs@X{AbIem@bA{JD_AIaAMg@o@{A_Ad@y@NaCLCsCK_FGI"
}
optimizedIntermediateWaypointIndex: 1
optimizedIntermediateWaypointIndex: 0
}
ในตัวอย่างนี้ สังเกตว่าการเพิ่มประสิทธิภาพจุดอ้างอิงจะกลับลำดับเดิม
แนวทางปฏิบัติที่แนะนำ
คำขอที่มีจุดอ้างอิงที่มีการเพิ่มประสิทธิภาพจะใช้เวลาประมวลผลนานกว่าคำขอกำหนดเส้นทางแบบง่าย ด้วยเหตุนี้ เราขอแนะนำให้คุณตั้งค่าระยะหมดเวลาที่สูงขึ้นสำหรับการเรียกเมธอด โดยกำหนดค่าสำหรับส่วนหัวของคำขอ X-Server-Timeout
ให้เป็นเวลาอย่างน้อย 10 วินาที หากยังคงได้รับข้อผิดพลาดการหมดเวลา คุณสามารถเพิ่มวินาทีอีกวินาทีแล้วลองอีกครั้งได้
ข้อจำกัดการใช้งาน
ในการใช้การเพิ่มประสิทธิภาพจุดอ้างอิง คุณต้องปฏิบัติตามข้อจำกัดและเงื่อนไขในการใช้งานต่อไปนี้
คุณสามารถระบุจุดอ้างอิงกลางบนเส้นทางของคุณได้สูงสุดขีดจำกัด ดังนี้
- จุดอ้างอิงสูงสุด 98 จุดโดยใช้เฉพาะพิกัดละติจูดและลองจิจูด
- จุดอ้างอิงสูงสุด 25 จุดหากคุณระบุจุดอ้างอิงโดยใช้รหัสสถานที่
จุดอ้างอิงทั้งหมดต้องเป็นประเภทแวะพัก จุดอ้างอิงไม่มีประเภทผ่านเลย
คุณต้องเพิ่ม
routes.optimizedIntermediateWaypointIndex
ลงในมาสก์ของช่องหากคำขอของคุณมีจุดอ้างอิงระดับกลาง 25 จุดขึ้นไป คำขอนั้นจะต้องเป็นไปตามเงื่อนไขต่อไปนี้ด้วย
ระยะทางสะสมของเส้นตรงระหว่างจุดอ้างอิงทั้งหมดต้องน้อยกว่า 1,000 กม. ระยะทางนี้รวมทั้งต้นทางและจุดหมาย
โหมดการเดินทางต้องเป็นไดรฟ์