Places API รองรับการค้นหาข้อความที่มีอยู่แล้ว หากคุณคุ้นเคยกับการค้นหาข้อความที่มีอยู่แล้ว การค้นหาข้อความเวอร์ชันใหม่จะทำการเปลี่ยนแปลงต่อไปนี้
- การค้นหาข้อความใหม่จะใช้คำขอ HTTP POST ส่งพารามิเตอร์ในเนื้อหาคำขอหรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ HTTP POST ในทางตรงกันข้าม เมื่อใช้การค้นหาข้อความที่มีอยู่ คุณจะส่งพารามิเตอร์ของ URL โดยใช้คำขอ HTTP GET
- ต้องมาสก์ช่อง คุณต้องระบุช่องที่ต้องการให้แสดงในคำตอบ ไม่มีรายการเริ่มต้นของฟิลด์ที่แสดงผล หากคุณไม่ใส่รายการนี้ เมธอดจะแสดงข้อผิดพลาด ดูข้อมูลเพิ่มเติมได้ใน FieldMask
- การค้นหาข้อความใหม่รองรับทั้งคีย์ API และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์
- รองรับเฉพาะ JSON เป็นรูปแบบการตอบสนองในการค้นหาข้อความใหม่
การค้นหาข้อความที่มีอยู่ช่วยให้คุณระบุพิกัดละติจูดและลองจิจูดในสตริงการค้นหาได้ เช่น
query=37.4239,-122.0925
การค้นหาข้อความใหม่ไม่รองรับตัวเลือกนี้ใช้ การระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับ เพื่อค้นหาพิกัดและแสดงผลที่อยู่ หรือใช้ การค้นหาใกล้เคียง (ใหม่) เพื่อค้นหาสถานที่ที่อยู่รอบๆ ตำแหน่งที่ต้องการ
- รูปแบบการตอบกลับ JSON สำหรับ Text Search (ใหม่) API เปลี่ยนจากรูปแบบของ API ที่มีอยู่ ดูรายละเอียดเพิ่มเติมได้ที่ย้ายข้อมูลการตอบกลับของ Places API
ตารางต่อไปนี้แสดงรายการพารามิเตอร์ในการค้นหาข้อความที่มีอยู่ซึ่งเปลี่ยนชื่อหรือแก้ไขสำหรับการค้นหาข้อความใหม่ หรือพารามิเตอร์ที่เราไม่รองรับอีกต่อไป
พารามิเตอร์ปัจจุบัน | พารามิเตอร์ใหม่ | Notes |
---|---|---|
evOptions |
พารามิเตอร์ใหม่ | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
ไม่รองรับ | |
query |
textQuery |
ต้องระบุในคำขอทั้งหมด |
radius |
locationBias |
ระบุรัศมีเมื่อกำหนด locationBias |
region |
regionCode |
|
type |
includedType |
รับเพียงค่าเดียวเท่านั้น |
strictTypeFiltering |
พารามิเตอร์ใหม่ |
ตัวอย่างคำขอ
ตัวอย่างคำขอ GET ต่อไปนี้ใช้การ ค้นหาข้อความที่มีอยู่ ในตัวอย่างนี้ คุณจะขอการตอบกลับ JSON ที่มีข้อมูลเกี่ยวกับ "Spicy Vegetarian Food ในซิดนีย์, Australia" และส่งพารามิเตอร์ทั้งหมดเป็นพารามิเตอร์ของ URL
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
เมื่อใช้การค้นหาข้อความ (ใหม่) คุณจะส่งคำขอ POST และส่งพารามิเตอร์ทั้งหมดในเนื้อหาของคำขอ JSON หรือในส่วนหัวให้เป็นส่วนหนึ่งของคำขอ POST ตัวอย่างนี้ยังใช้มาสก์ฟิลด์เพื่อให้การตอบกลับมีเฉพาะชื่อที่แสดงและที่อยู่ที่จัดรูปแบบของสถานที่ด้วย
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'