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

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

บทนำ

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

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

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

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