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

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'