Places API hỗ trợ API địa điểm Tự động hoàn thành và Tự động hoàn thành truy vấn. 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 tham số vào phần nội dung yêu cầu hoặc trong tiêu đề như 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 chuyể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ả hai 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 thành phần Các API Tự động hoàn thành và Truy vấn tự động hoàn thành đã đượ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ỏ qua cả locationBias và locationRestriction, thì phương thức
Theo mặc định, API sử dụng xu hướng IP. |
|
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 phương thức
Tự động hoàn thành địa điểm. Trong ví dụ này, bạn yêu cầu một tệp JSON
câu trả lời có chứa thông tin về những địa điểm có tên là "Amoeba" thuộc loại
establishment rồi truyền tất 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 tạo yêu cầu POST và truyền tất cả tham số trong nội dung của yêu cầu JSON hoặc trong tiêu đề dưới dạng một phần của POST của bạn. 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ỉ được đị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