Places API สนับสนุน เติมข้อความอัตโนมัติ และ Query Autocomplete API หากคุณคุ้นเคยกับ API เหล่านี้ การเติมข้อความอัตโนมัติ (ใหม่) จะทำการเปลี่ยนแปลงต่อไปนี้
- การเติมข้อความอัตโนมัติ (ใหม่) ใช้คำขอ HTTP POST ส่งพารามิเตอร์ใน เนื้อหาของคำขอหรือในส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ HTTP POST ในทางตรงกันข้าม ด้วย API ที่มีอยู่ คุณจะส่งพารามิเตอร์ URL โดยใช้ คำขอ HTTP GET
- การเติมข้อความอัตโนมัติ (ใหม่) รองรับคีย์ API ทั้ง 2 แบบ และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์
- รองรับเฉพาะ JSON เป็นรูปแบบการตอบกลับในการเติมข้อความอัตโนมัติ (ใหม่)
ตารางต่อไปนี้แสดงพารามิเตอร์ใน API การเติมข้อความอัตโนมัติและ Query Autocomplete API ที่มีการเปลี่ยนชื่อหรือแก้ไขสำหรับการเติมข้อความอัตโนมัติ (ใหม่) หรือพารามิเตอร์ที่ไม่ได้รับการสนับสนุนอีกต่อไป
พารามิเตอร์ปัจจุบัน | พารามิเตอร์ใหม่ | หมายเหตุ |
---|---|---|
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 ต่อไปนี้ใช้
เติมข้อมูลสถานที่อัตโนมัติ ในตัวอย่างนี้ คุณจะส่งคำขอ JSON
คำตอบที่มีข้อมูลเกี่ยวกับสถานที่ที่เรียกว่า "อะมีบา" ที่เป็นประเภท
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 อีกครั้ง ตัวอย่างนี้ยังใช้มาสก์ฟิลด์เพื่อให้การตอบกลับมีเพียงฟิลด์ ชื่อที่แสดงและที่อยู่ที่จัดรูปแบบของสถานที่:
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" \ https://places.googleapis.com/v1/places:autocomplete