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

บทนำ

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

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

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

  ใช้ Reverse Geocoding เพื่อค้นหาพิกัดและแสดงผลที่อยู่ หรือ Nearby Search (ใหม่) เพื่อค้นหาสถานที่รอบๆ ตำแหน่งที่ตั้งหนึ่งๆ

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

เมื่อใช้ Text Search (ใหม่) คุณจะส่งคำขอ 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'