ย้ายข้อมูลไปยังการค้นหาข้อความ (ใหม่)

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'