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

Places API สนับสนุน การค้นหาข้อความ หากคุณคุ้นเคยกับ การค้นหาข้อความ การค้นหาข้อความเวอร์ชันใหม่ ทำการเปลี่ยนแปลงต่อไปนี้

• การค้นหาข้อความใหม่จะใช้คำขอ HTTP POST บัตร ในเนื้อหาคำขอหรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ HTTP POST ในทางกลับกัน เมื่อใช้การค้นหาข้อความที่มีอยู่ พารามิเตอร์ของ URL ที่ใช้คำขอ HTTP GET
• ต้องมาสก์ช่อง คุณต้องระบุฟิลด์ที่คุณต้องการให้แสดงผล ในการตอบกลับ ไม่มีรายการเริ่มต้นของฟิลด์ที่แสดงผล หากคุณไม่ใส่ เมธอดจะแสดงข้อผิดพลาด สำหรับข้อมูลเพิ่มเติม โปรดดู FieldMask
• การค้นหาข้อความใหม่รองรับคีย์ API ทั้ง 2 แบบ และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์
• รองรับเฉพาะ JSON เป็นรูปแบบการตอบสนองใน การค้นหาข้อความ

• คุณสามารถใช้การค้นหาข้อความที่มีอยู่เพื่อระบุละติจูดและลองจิจูด ในสตริงข้อความค้นหา เช่น query=37.4239,-122.0925 การค้นหาข้อความใหม่ไม่รองรับตัวเลือกนี้

  ใช้ การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ เพื่อค้นหาพิกัดและส่งกลับที่อยู่ หรือ การค้นหาใกล้เคียง (ใหม่) เพื่อค้นหาสถานที่รอบๆ สถานที่หนึ่ง

• รูปแบบการตอบสนอง JSON สำหรับการค้นหาข้อความ (ใหม่) API เปลี่ยนจากรูปแบบของ API ที่มีอยู่ ดูรายละเอียดเพิ่มเติมได้ที่ ย้ายข้อมูลการตอบกลับของ Places API

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

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