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

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

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

ตารางต่อไปนี้แสดงพารามิเตอร์ใน Autocomplete 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

ฟิลด์มาสก์ไม่จำเป็นสำหรับคำขอการเติมข้อความอัตโนมัติ (ใหม่) แต่ก็สามารถเป็น ใช้เพื่อกรองหาผลลัพธ์ที่เจาะจงในคำตอบ ตัวอย่างเช่น URL ต่อไปนี้ ใช้มาสก์ฟิลด์เพื่อให้การตอบกลับมีเฉพาะฟิลด์ 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

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