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

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

บทนำ

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

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

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

  • รูปแบบการตอบกลับ JSON สำหรับการค้นหาข้อความ (ใหม่) มีการเปลี่ยนแปลงจากรูปแบบของ 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'