API Địa điểm hỗ trợ các API Tự động hoàn thành và Tự động hoàn thành truy vấn hiện có. Nếu bạn quen thuộc với các API này, tính năng Tự động hoàn thành (Mới) sẽ thực hiện những thay đổi sau:
- Tính năng Tự động hoàn thành (Mới) sử dụng các yêu cầu POST qua HTTP. Truyền các tham số vào nội dung yêu cầu hoặc trong tiêu đề dưới dạng một phần của yêu cầu HTTP POST. Ngược lại, với các API hiện có, bạn sẽ truyền tham số URL bằng cách sử dụng yêu cầu HTTP GET.
- Tính năng Tự động hoàn thành (Mới) hỗ trợ cả khoá API và mã thông báo OAuth làm cơ chế xác thực.
- Trong tính năng Tự động hoàn thành (Mới), chỉ JSON mới được hỗ trợ làm định dạng phản hồi.
Bảng sau đây liệt kê các tham số trong API Tự động hoàn thành và API Tự động hoàn thành truy vấn hiện có đã được đổi tên hoặc sửa đổi cho tính năng Tự động hoàn thành (Mới) hoặc các tham số không còn được hỗ trợ.
Thông số hiện tại | Thông số mới | Ghi chú |
---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Nếu bạn bỏ qua cả locationBias và locationRestriction , thì API sẽ sử dụng xu hướng IP theo mặc định. |
|
offset |
inputOffset |
|
radius |
locationBias hoặc locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Yêu cầu mẫu
Yêu cầu GET trong ví dụ sau đây sử dụng tính năng Tự động hoàn thành địa điểm hiện có. Trong ví dụ này, bạn yêu cầu phản hồi JSON chứa thông tin về các địa điểm có tên là "Amoeba" thuộc kiểu establishment
và chuyển tất cả các tham số dưới dạng tham số 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'
Với tính năng Tự động hoàn thành mới, bạn sẽ tạo một yêu cầu POST và truyền mọi tham số trong nội dung yêu cầu JSON hoặc trong tiêu đề theo yêu cầu POST. Ví dụ này cũng sử dụng một mặt nạ trường để phản hồi chỉ bao gồm tên hiển thị và địa chỉ đã định dạng của địa điểm:
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