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

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'