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

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

บทนำ

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

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

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

พารามิเตอร์ปัจจุบัน	พารามิเตอร์ใหม่	หมายเหตุ
`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'

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

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

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