โดยค่าเริ่มต้น Routes API จะแสดงเส้นทางเริ่มต้น ซึ่งโดยทั่วไปจะเป็นเส้นทางที่เร็วที่สุดจากต้นทางไปยังปลายทาง เมื่อขอเส้นทางสำรอง API จะแสดงผลเส้นทางสูงสุด 3 เส้นทางพร้อมกับเส้นทางเริ่มต้น จากนั้นลูกค้าจะเลือกเส้นทางที่เหมาะกับความต้องการของตนที่สุดได้
ข้อควรพิจารณาเมื่อขอเส้นทางอื่น
หากต้องการขอเส้นทางอื่น โปรดคำนึงถึงข้อควรพิจารณาต่อไปนี้
คุณจะขอได้เฉพาะเส้นทางสำรองสำหรับเส้นทางที่ไม่มีจุดระหว่างทาง การขอเส้นทางอื่นเมื่อเส้นทางระบุจุดอ้างอิงกลางไม่ทำให้เกิดข้อผิดพลาด แต่จะไม่มีการส่งคืนเส้นทางสำรอง
คำตอบมีเส้นทางเลือกได้สูงสุด 3 เส้นทาง อย่างไรก็ตาม บางครั้งไม่มีเส้นทางสำรอง ดังนั้นการตอบกลับจะมีเฉพาะเส้นทางเริ่มต้น
เนื่องจากต้องมีการประมวลผลเพิ่มเติมเพื่อคำนวณเส้นทางสำรอง การขอเส้นทางอื่นจึงอาจเพิ่มเวลาในการตอบกลับของ API
ตัวอย่างคำขอเส้นทางสำรอง
ตั้งค่า computeAlternativeRoutes
เป็น true
เพื่อขอเส้นทางอื่น ตัวอย่างต่อไปนี้แสดงวิธีขอเส้นทางสำรองในคำขอเมธอด computeRoutes (REST)
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude":42.340173523716736, "longitude":-71.05997968330408 } } }, "destination":{ "location":{ "latLng":{ "latitude":42.075698891472804, "longitude": -72.59806562080408 } } }, "travelMode": "DRIVE", "routingPreference":"TRAFFIC_AWARE", "computeAlternativeRoutes": true }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
ในตัวอย่างนี้ คุณระบุฟิลด์มาสก์เพื่อให้การตอบกลับมีเฉพาะพร็อพเพอร์ตี้ duration
, distanceMeters,
และ routeLabels
สำหรับแต่ละเส้นทาง จากนั้นลูกค้าจะใช้ข้อมูลดังกล่าวเพื่อเลือกเส้นทางที่จะใช้ ดูข้อมูลเพิ่มเติมได้ที่เลือกข้อมูลที่จะแสดง
ตัวอย่างการตอบกลับเส้นทางอื่น
ในการตอบสนอง ให้ใช้พร็อพเพอร์ตี้อาร์เรย์ routeLabels
เพื่อระบุเส้นทางการเข้าถึง ดังนี้
พร็อพเพอร์ตี้
routeLabels
จะมีDEFAULT_ROUTE
สำหรับเส้นทางเริ่มต้นสำหรับเส้นทางอื่น พร็อพเพอร์ตี้
routeLabels
จะมีDEFAULT_ROUTE_ALTERNATE
ในตัวอย่างนี้ การตอบกลับประกอบด้วยเส้นทางเริ่มต้นและเส้นทางเลือก 2 รายการ โปรดสังเกตว่าค่าของพร็อพเพอร์ตี้ duration
และ distanceMeters
นั้นแตกต่างกันในแต่ละเส้นทาง
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }
รวมโพลีไลน์ในคำตอบ
เพิ่มเส้นประกอบสำหรับแต่ละเส้นทางในคำตอบเพื่อให้ผู้ใช้เลือกเส้นทางได้ง่ายขึ้น จากนั้นคุณจะแสดงเส้นประกอบแต่ละเส้นบนแผนที่ได้
หากต้องการเพิ่มเส้นประกอบ ให้ใส่ routes.polyline
ในมาสก์ของช่องข้อมูลดังนี้
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'
จากนั้นคำตอบจะมีเส้นประกอบสำหรับแต่ละเส้นทาง ดังนี้
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "polyline": { "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "polyline": { "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "polyline": { "encodedPolyline": "FVLL|Af@HPAV…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }