Places API hỗ trợ API địa điểm Tìm kiếm lân cận. Nếu bạn đã quen thuộc với tính năng Tìm kiếm lân cận hiện có, phiên bản mới của tính năng Tìm kiếm lân cận thực hiện các thay đổi sau:
- Tính năng Tìm kiếm lân cận mới sử dụng các yêu cầu POST qua HTTP. Truyền các tham số vào phần 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 POST qua HTTP của bạn. Ngược lại, với tính năng Tìm kiếm lân cận hiện có, bạn truyền tham số URL bằng cách sử dụng yêu cầu HTTP GET.
- Bắt buộc phải che trường. Bạn phải chỉ định những trường mà bạn muốn trả về trong câu trả lời. Không có danh sách mặc định các trường được trả về. Nếu bạn bỏ qua danh sách này, phương thức sẽ trả về một lỗi. Để biết thêm thông tin, hãy xem FieldMask (Mặt nạ trường).
- Tính năng Tìm kiếm lân cận mới hỗ trợ cả Khoá API và OAuth làm cơ chế xác thực.
- Chỉ JSON được hỗ trợ làm định dạng phản hồi trong Tìm kiếm lân cận.
- Giờ đây, tất cả các yêu cầu có bao gồm truy vấn văn bản sẽ sử dụng Tìm kiếm văn bản (Mới) vì tính năng Tìm kiếm lân cận (Mới) không hỗ trợ nhập văn bản.
- Định dạng phản hồi JSON cho Tìm kiếm lân cận (Mới) API đã thay đổi so với định dạng của các API hiện có. Để biết thêm thông tin, hãy xem Di chuyển phản hồi của API Địa điểm.
Bảng sau đây liệt kê các tham số trong thành phần Tìm kiếm lân cận đã được đổi tên hoặc sửa đổi cho Tìm kiếm lân cận mới hoặc các thông số không còn được hỗ trợ.
| Thông số hiện tại | Thông số mới | Ghi chú |
|---|---|---|
keyword |
Không được hỗ trợ. Sử dụng Tìm kiếm văn bản (Mới) thay thế. | |
language |
languageCode |
|
location |
locationRestriction |
Bắt buộc. |
maxprice/minprice |
|
Không được hỗ trợ. |
maxResultCount |
Tham số mới. | |
opennow |
|
Không được hỗ trợ. |
pagetoken |
Không được hỗ trợ. | |
radius |
|
Dùng locationRestriction ngay. |
rankby |
rankPreference |
|
regionCode |
Tham số mới. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Các tham số mới cũng chấp nhận nhiều giá trị loại. API hiện có chỉ chấp nhận một giá trị duy nhất. |
Yêu cầu mẫu
Yêu cầu GET trong ví dụ sau đây sử dụng phương thức
Tìm kiếm lân cận. 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ề các địa điểm thuộc loại restaurant và chuyển tất cả
làm tham số URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
Với tính năng Tìm kiếm lân cận (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 '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby