คุณสามารถรวมการคำนวณสรุปเส้นทางเข้ากับการค้นหาตามเส้นทางได้ ในกรณีนี้ การค้นหาข้อความ (ใหม่) จะแสดงระยะเวลาและระยะทางในการเดินทางไปยัง ในการตอบสนอง และจากแต่ละที่ไปยังปลายทางสุดท้ายของ เส้นทาง
เพื่อใช้การค้นหาข้อความ (ใหม่) เพื่อคำนวณสรุปการกำหนดเส้นทางไปพร้อมกับการค้นหา ระหว่างเส้นทาง:
ใช้ Routes API เพื่อคำนวณเส้นทางที่แสดงผลรูปหลายเหลี่ยมของเส้นทางในการตอบกลับ
ใช้พารามิเตอร์
searchAlongRouteParameters.polyline.encodedPolyline
เพื่อ ส่งผ่านโพลีไลน์ของเส้นทางไปยังการค้นหาข้อความ (ใหม่) เพื่อให้ผลการค้นหาให้น้ำหนักกับ เส้นทาง จากนั้นการตอบกลับจะมีสถานที่ที่ตรงกับเกณฑ์การค้นหาและอยู่ใกล้กับเส้นทางที่ระบุด้วยใส่
routingSummaries
ในมาสก์ของช่องเพื่อให้คำตอบรวม อาร์เรย์routingSummaries
อาร์เรย์นี้มีระยะเวลาและระยะทาง ต้นทางการกำหนดเส้นทางไปยังแต่ละจุดในคำตอบ
โดยค่าเริ่มต้น การค้นหาข้อความ (ใหม่) จะทำการค้นหาตลอดเส้นทาง ดังนี้
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "searchAlongRouteParameters": { "polyline": { "encodedPolyline": "ROUTE_POLYLINE" } } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \ 'https://places.googleapis.com/v1/places:searchText'
การตอบกลับประกอบด้วย 2 อาร์เรย์: อาร์เรย์ places
ที่มีการจับคู่
และอาร์เรย์ routingSummaries
มีระยะเวลาและระยะทางถึง
เดินทางไปสถานที่แต่ละแห่ง
{ "places": [ { "formattedAddress": "1477 Plymouth St suite c, Mountain View, CA 94043, USA", "priceLevel": "PRICE_LEVEL_INEXPENSIVE", "displayName": { "text": "Zareen's", "languageCode": "en" } }, { "formattedAddress": "2464 W El Camino Real C, Mountain View, CA 94040, USA", "priceLevel": "PRICE_LEVEL_INEXPENSIVE", "displayName": { "text": "Veggie Garden", "languageCode": "en" } }, … ], "routingSummaries": [ { "legs": [ { "duration": "285s", "distanceMeters": 1616 }, { "duration": "2466s", "distanceMeters": 58147 } ] }, { "legs": [ { "duration": "696s", "distanceMeters": 4704 }, { "duration": "2787s", "distanceMeters": 58901 } ] }, … ] }
สำหรับการค้นหาข้อความ (ใหม่) แต่ละรายการในอาร์เรย์ legs
จะแสดงเวลาเดินทาง 2 ช่วง ดังนี้
ขาแรกประกอบด้วยระยะเวลาการเดินทางและระยะทางจากต้นทางถึง สถานที่นั้น ในตัวอย่างนี้ ระยะเวลาและระยะทางจากต้นทางถึง อยู่ในอันดับแรกในผลการค้นหาคือ 285 วินาทีและ 1,616 เมตร
ส่วนช่วงที่สองจะมีระยะเวลาเดินทางและระยะทางจากจุดนั้นๆ ไปยังจุดหมายของเส้นทาง ในตัวอย่างนี้ ระยะเวลาและระยะทางคือ 2466 วินาที และ 58147 เมตร
ระบุต้นทางของเส้นทาง โหมดการเดินทาง และตัวปรับเปลี่ยนเส้นทาง
คุณสามารถแก้ไขการคำนวณการค้นหาและการกำหนดเส้นทางโดยสรุปได้โดยระบุ ต้นทางของการกำหนดเส้นทาง โหมดการเดินทาง ตัวปรับเปลี่ยนเส้นทาง และค่ากำหนดการกำหนดเส้นทาง ตัวเลือกโหมดการเดินทางและตัวแก้ไขเส้นทางจะทํางานเหมือนกับการคํานวณสรุปเส้นทางโดยไม่ได้ระบุเส้นทาง ดังที่แสดงในระบุตัวเลือกการเดินทาง
โดยค่าเริ่มต้น ขาแรกของผลลัพธ์แต่ละรายการจะมีระยะห่างจากต้นทาง เส้นประกอบของแต่ละตำแหน่ง อย่างไรก็ตาม คุณสามารถลบล้างค่าเริ่มต้นนั้นได้ ระบุต้นทางของการกำหนดเส้นทางในคำขออย่างชัดแจ้ง หากระบุไว้ ระยะทางแรกของการตอบกลับทั้งหมดจะระบุระยะทางและระยะเวลาจากต้นทางการกำหนดเส้นทางที่ระบุ ซึ่งจะลบล้างต้นทางจากเส้นประกอบ
ในตัวอย่างถัดไป คุณจะระบุจุดเริ่มต้นของเส้นทางเป็นพิกัดของซานมาเทโอ รัฐแคลิฟอร์เนีย ระบุให้หลีกเลี่ยงทางด่วน และตั้งค่าจำนวนผลลัพธ์เป็น 5
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "maxResultCount": 5, "searchAlongRouteParameters": { "polyline": { "encodedPolyline": "ROUTE_POLYLINE" } }, "routingParameters": { "origin": { "latitude": 37.56617, "longitude": -122.30870 }, "travelMode":"DRIVE", "routeModifiers": { "avoidTolls": true } } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \ 'https://places.googleapis.com/v1/places:searchText'
รูปภาพต่อไปนี้แสดงแผนที่ที่มีเส้นประกอบของเส้นทาง จุดเริ่มต้นใหม่ (หมุดสีน้ำเงินอ่อน) และสถานที่ในผลการค้นหา (หมุดสีเขียว) โปรดสังเกตว่าผลการค้นหาทั้งหมดอยู่ตามเส้นทางแต่ผ่านซาน มาเทโอ