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

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

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

ตารางต่อไปนี้แสดงรายการพารามิเตอร์ใน API การเติมข้อความอัตโนมัติและการเติมข้อความค้นหาอัตโนมัติที่มีอยู่ ซึ่งได้เปลี่ยนชื่อหรือแก้ไขสำหรับการเติมข้อความอัตโนมัติ (ใหม่) หรือพารามิเตอร์ที่ระบบไม่รองรับอีกต่อไป

พารามิเตอร์ปัจจุบัน พารามิเตอร์ใหม่ Notes
components includedRegionCodes
language languageCode
location locationBias
ipbias หากคุณไม่ใส่ทั้ง locationBias และ locationRestriction API จะใช้การให้น้ำหนัก IP โดยค่าเริ่มต้น
offset inputOffset
radius locationBias หรือ locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

ตัวอย่างคำขอ

ตัวอย่างคำขอ GET ต่อไปนี้ใช้การเติมข้อความอัตโนมัติเกี่ยวกับสถานที่ที่มีอยู่ ในตัวอย่างนี้ คุณจะขอการตอบสนอง JSON ที่มีข้อมูลเกี่ยวกับสถานที่ที่เรียกว่า "Amoeba" ที่เป็นประเภท establishment และส่งพารามิเตอร์ทั้งหมดเป็นพารามิเตอร์ของ URL

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

เมื่อใช้การเติมข้อความอัตโนมัติใหม่ คุณจะส่งคำขอ POST และส่งผ่านพารามิเตอร์ทั้งหมดในเนื้อหาของคำขอ JSON หรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ POST ตัวอย่างนี้ยังใช้มาสก์ฟิลด์เพื่อให้การตอบกลับมีเฉพาะชื่อที่แสดงและที่อยู่ที่จัดรูปแบบของสถานที่ด้วย

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete