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

บทนำ

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

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

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

พารามิเตอร์ปัจจุบัน	พารามิเตอร์ใหม่	หมายเหตุ
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 ตัวอย่างต่อไปนี้ใช้ Place Autocomplete (เวอร์ชันเดิม) ในตัวอย่างนี้ คุณขอการตอบกลับ 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'

เมื่อใช้ Autocomplete (เวอร์ชันใหม่) คุณจะส่งคำขอ POST และส่งพารามิเตอร์ทั้งหมดในเนื้อหาคำขอ JSON หรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ POST

ไม่จำเป็นต้องใช้ฟิลด์มาสก์สำหรับคำขอ Autocomplete (เวอร์ชันใหม่) แต่คุณสามารถใช้ฟิลด์มาสก์เพื่อกรองผลลัพธ์ที่เฉพาะเจาะจงในการตอบกลับได้ ตัวอย่างเช่น คำขอต่อไปนี้ใช้ฟิลด์มาสก์เพื่อให้การตอบกลับมีเฉพาะ suggestions.placePrediction.text ของคำแนะนำ

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' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ฟิลด์มาสก์ได้ที่ รายละเอียดสถานที่ (เวอร์ชันใหม่)