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

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

บทนำ

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

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

ตารางต่อไปนี้แสดงพารามิเตอร์ใน Place 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 ได้ที่รายละเอียดสถานที่ (ใหม่)