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

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

ตารางต่อไปนี้แสดงพารามิเตอร์ในข้อความค้นหาที่มีอยู่ซึ่งเปลี่ยนชื่อหรือแก้ไขแล้วสําหรับข้อความค้นหาใหม่ หรือพารามิเตอร์ที่ไม่รองรับอีกต่อไป

พารามิเตอร์ปัจจุบัน	พารามิเตอร์ใหม่	หมายเหตุ
	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'