ค้นหาบนเส้นทาง
หากต้องการใช้ การค้นหาข้อความ (ใหม่) เพื่อค้นหาบนเส้นทาง ให้ส่งเส้นทางที่คำนวณไว้ล่วงหน้า จาก Routes API ใน คำขอเป็นเส้นโพลีไลน์ คำตอบจะมีสถานที่ที่ตรงกับเกณฑ์การค้นหาและอยู่ใกล้กับเส้นทางที่ระบุ
วิธีค้นหาบนเส้นทาง
-
ใช้ Routes API เพื่อคำนวณเส้นทางที่ แสดงผลเส้นประกอบที่เข้ารหัสของเส้นทาง ในคำตอบ
-
ใช้พารามิเตอร์
searchAlongRouteParameters.polyline.encodedPolylineเพื่อ ส่งเส้นโพลีไลน์ที่เข้ารหัสของเส้นทางไปยังการค้นหาข้อความ (ใหม่) เพื่อกำหนดผลการค้นหาให้เป็นเส้นทาง จากนั้นคำตอบจะมีสถานที่ที่ตรงกับเกณฑ์การค้นหาและอยู่ใกล้กับเส้นทางที่ระบุ
โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอแบบสดๆ เพื่อให้คุ้นเคยกับ API และตัวเลือก API
โดยค่าเริ่มต้น การค้นหาข้อความ (ใหม่) จะทำการค้นหาตามเส้นทางทั้งหมดจากต้นทางไปยังปลายทางตามที่กำหนดโดยเส้นประกอบ ในตัวอย่างต่อไปนี้ เส้นโพลีไลน์จะกำหนดเส้นทางจาก
- ต้นทาง: 1600 Amphitheatre Parkway, Mountain View, CA
- ปลายทาง: 24 Willie Mays Plaza, San Francisco, CA
เส้นโพลีไลน์ที่เข้ารหัสของการเดินทางสำหรับเส้นทางนี้แสดงด้วยสตริงต่อไปนี้
wblcFptchVIFOd@G@EVw@Ms@dHKR}ApNA`AF~@Hf@TjAb@bBb@~@n@p@^Rd@~@Vz@HVz@nDLt@?d@Kr@c@~@mD`G?`@aEfGkCnDuChDm`@bb@[`@{GhHeEdEciBnnBkC`DkC~DaClEuKjT_Z|l@Qb@iR~_@}EzJ_AdB_Und@kAfCaOjZkg@vcAqBzD_]rr@iBlEaBxEgArD}AlG}AhHsA`IeAnH{@dIq@dJgL~iBq@rHu@vGgAtHwArHaBhHkBzG_DpJ}Nbc@iBhGkA|EgC|LcIjb@oAhG_AvDgAdDkApC_BzCiBpCsFvGii@vn@scAxlAmLjNgSzUeRjT{TzWqExEmG|FuNlMmMhLaRvPqOlNmbAl}@mFlF{PlOmJfIoElE}LtMiSbU_H`I}}@jcAwl@vp@oAbBqA~BeAhCm@tBg@fCWrBQ~BI|DaB~rBO~D[bEa@`Dm@pDaAdE{@vC_BbEkB~Def@|z@sEzHKJeS~]}K`S{\\~l@cXpe@sBpDm@bAuCxDkBrBiC~BwCtByBnAcBx@}Bt@{Bn@gh@|LaOpDeFhAoDj@aE^kVrA_E^iEr@yD~@uBr@gMjF_EnAcCh@eFr@_DRsAD}@Jsu@xCWDqIV}BCeCOyDm@cBa@_DmA}JeE_CwAsBcBiBoBuAqBmOoX{CuEkB_CoDqDkVoUoD{CeE_DkEkC_FeCqB}@sDuAoDgAeCe@cCW}CK}BDaDTeOlBcuBrYaNlBq@Dyd@rGyFt@yBb@eBf@oCnAoBlAkIpGkAp@wBbAaCt@oFdAwKjBoGxA{FbByIjC_HfB_@KmNdDuC|@uFzBcH|C{@\\[?sBv@}@VaBVoA@y@EmAQcA[w@]aBkAeAkA}BuDUKs@uAqBsCwBcCgAiAiN_MyKsJsG{GkBaBiBuA{BwAwDkBcOaHiC_AiCg@}BQcCAcBHqBVkB`@qEjAu@LgCVgAHwG@sG?mABsH^eNr@mBXy@NqBt@uAt@aBlAkAlA}BtCyApBiAdB_BxB{A`B}@j@oAf@s@PeCVcIf@gAAkAQy@YiAo@_A{@_DgEgJqM_DeEaM}PoBiCzAsBw@kAdAGVk@f@q@z@Cตัวอย่างต่อไปนี้ใช้เส้นประกอบที่เข้ารหัสของเส้นทางเพื่อให้น้ำหนักพิเศษกับผลการค้นหา
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' \
'https://places.googleapis.com/v1/places:searchText'คำตอบจะมีสถานที่ที่ตรงกับเกณฑ์การค้นหา โดยกำหนดให้เป็นเส้นทาง
{ "places": [ { "formattedAddress": "60 Morris St, San Francisco, CA 94107, USA", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Umami Express", "languageCode": "en" } }, { "formattedAddress": "1130 4th St, San Francisco, CA 94158, USA", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "House of Tadu Ethiopian Kitchen", "languageCode": "en" } }, { "formattedAddress": "1602 El Camino Real Ste A, Belmont, CA 94002, USA", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Eats Meets West Bowls", "languageCode": "en" } }, /.../ ] }
คุณไม่จำเป็นต้องกำหนดผลการค้นหาให้เป็นเส้นทางทั้งหมด เช่น คุณอาจเดินทางมาได้ครึ่งทางแล้วก่อนที่จะทำการค้นหา ในกรณีนี้ คุณสามารถระบุต้นทางของการกำหนดเส้นทางที่ชัดเจนในการค้นหาเพื่อลบล้างต้นทาง ที่กำหนดไว้ในเส้นโพลีไลน์ที่เข้ารหัส ในตัวอย่างต่อไปนี้ คุณระบุพิกัดละติจูดและลองจิจูดของ San Mateo, CA ซึ่งอยู่ประมาณครึ่งทางตามเส้นประกอบของเส้นทาง
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food",
"searchAlongRouteParameters": {
"polyline": {
"encodedPolyline": "ROUTE_POLYLINE"
}
},
"routingParameters": {
"origin": {
"latitude": 37.56617,
"longitude": -122.30870
}
}
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'ลองใช้งาน
โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอตัวอย่างเพื่อให้คุ้นเคยกับ API และตัวเลือก API
เลือกไอคอน API api ทางด้านขวาของหน้า
เลือกแก้ไขพารามิเตอร์คำขอ (ไม่บังคับ)
เลือกปุ่มเรียกใช้ ในกล่องโต้ตอบ ให้เลือกบัญชี ที่ต้องการใช้ส่งคำขอ
ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนเต็มหน้าจอ fullscreen เพื่อขยายหน้าต่างโปรแกรมสำรวจ API