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 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 các tham số trong nội dung yêu cầu hoặc trong tiêu đề như một phần của yêu cầu POST HTTP. 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.
- Chỉ hỗ trợ JSON làm định dạng phản hồi trong tính năng Tự động hoàn thành (Mớ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ợ.
| Tham 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 mẫu 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 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 bạn có thể sử dụng mặt nạ trường để lọc ra các kết quả cụ thể trong phản hồi. Ví dụ: yêu cầu sau đây sử dụng mặt nạ trường để phản hồi chỉ bao gồm suggestions.placePrediction.text của đề 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).