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

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

บทนำ

Places API รองรับ Place Autocomplete (เดิม) และ Query Autocomplete (เดิม) API หากคุณคุ้นเคยกับ 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

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

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