Places API สนับสนุนการค้นหาข้อความที่มีอยู่ หากคุณคุ้นเคยกับการค้นหาข้อความที่มีอยู่แล้ว Text Search เวอร์ชันใหม่จะทำการเปลี่ยนแปลงต่อไปนี้
- การค้นหาข้อความแบบใหม่ใช้คำขอ HTTP POST ส่งพารามิเตอร์ในเนื้อหาคำขอหรือในส่วนหัวเป็นส่วนหนึ่งของคำขอ HTTP POST ในทางกลับกัน เมื่อใช้การค้นหาข้อความที่มีอยู่ คุณจะส่งผ่านพารามิเตอร์ของ URL โดยใช้คำขอ HTTP GET ได้
- ต้องระบุฟิลด์มาสก์ คุณต้องระบุช่องที่ต้องการให้แสดงผลในคำตอบ ไม่มีรายการเริ่มต้นของฟิลด์ที่แสดงผล หากคุณไม่ใช้รายการนี้ เมธอดจะแสดงข้อผิดพลาด ดูข้อมูลเพิ่มเติมได้ที่ FieldMask
- การค้นหาข้อความแบบใหม่รองรับทั้งโทเค็น API และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์
- ระบบรองรับ JSON เป็นรูปแบบการตอบสนองในการค้นหาข้อความแบบใหม่เท่านั้น
การค้นหาข้อความที่มีอยู่ให้คุณระบุพิกัดละติจูดและลองจิจูดในสตริงการค้นหาได้ เช่น
query=37.4239,-122.0925
การค้นหาข้อความแบบใหม่ไม่รองรับตัวเลือกนี้ใช้การระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับเพื่อค้นหาพิกัดและแสดงที่อยู่ หรือใช้การค้นหาใกล้เคียง (ใหม่) เพื่อค้นหาสถานที่รอบๆ ตำแหน่งใดตำแหน่งหนึ่ง
- รูปแบบการตอบสนอง JSON สำหรับ 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 ที่มีข้อมูลเกี่ยวกับ "อาหารมังสวิรัติรสเผ็ดในซิดนีย์ ออสเตรเลีย" และส่งพารามิเตอร์ทั้งหมดเป็นพารามิเตอร์ของ 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'