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

นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)

บทนำ

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

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

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

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

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

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

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