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