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

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

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

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

พารามิเตอร์ปัจจุบัน พารามิเตอร์ใหม่ หมายเหตุ
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 คำตอบที่มีข้อมูลเกี่ยวกับสถานที่ที่เรียกว่า "อะมีบา" ที่เป็นประเภท 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