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

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

• ฟีเจอร์เติมข้อความอัตโนมัติ (ใหม่) ใช้คำขอ HTTP POST ส่งพารามิเตอร์ในเนื้อหาคำขอหรือในส่วนหัวเป็นส่วนหนึ่งของคำขอ HTTP POST ในทางตรงกันข้าม เมื่อใช้ API ที่มีอยู่ คุณจะส่งพารามิเตอร์ URL โดยใช้คำขอ HTTP GET
• ฟีเจอร์เติมข้อความอัตโนมัติ (ใหม่) รองรับทั้งคีย์ API และโทเค็น 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 ที่มีข้อมูลเกี่ยวกับสถานที่ชื่อ "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

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

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