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

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

บทนำ

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

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

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

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

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