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 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 điền (Mới) sử dụng các yêu cầu POST 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 truyền các tham số URL bằng yêu cầu GET HTTP.
- 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 API 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ì theo mặc định, API sẽ sử dụng độ lệch 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 phản hồi
JSON chứa thông tin về các địa điểm có tên là "Amoeba" thuộc loại
establishment và truyề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 tất cả các tham số trong nội dung yêu cầu JSON hoặc trong tiêu đề như một phần của yêu cầu POST.
Bạn không bắt buộc phải sử dụng mặt nạ trường cho các yêu cầu Tự động hoàn thành (Mới), nhưng loại này có thể
dùng để lọc kết quả cụ thể trong câu trả lời. Ví dụ: như sau
yêu cầu sử dụng mặt nạ trường để phản hồi chỉ bao gồm
suggestions.placePrediction.text đề xuất:
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
Để tìm hiểu thêm về cách sử dụng mặt nạ trường, hãy xem phần Thông tin chi tiết về địa điểm (Mới).