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

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'