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