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

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

บทนำ

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

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

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