Places API hỗ trợ tính năng Tìm kiếm địa điểm lân cận (Cũ). Nếu bạn đã quen thuộc với tính năng Tìm kiếm địa điểm lân cận (Cũ), thì tính năng Tìm kiếm địa điểm lân cận (Mới) sẽ có những thay đổi sau:
- Tìm kiếm lân cậ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 HTTP POST. Ngược lại, với tính năng Tìm kiếm lân cận (Cũ), bạn truyền các tham số URL bằng yêu cầu GET HTTP.
- Bạn phải che trường. Bạn phải chỉ định những trường mà bạn muốn được trả về trong phản hồi. Không có danh sách mặc định về các trường được trả về. Nếu bạn bỏ qua danh sách này, các phương thức sẽ trả về lỗi. Để biết thêm thông tin, hãy xem phần FieldMask.
- Tìm kiếm lân cận (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ìm kiếm địa điểm lân cận (Mới).
- Tất cả các yêu cầu có cụm từ tìm kiếm dạng văn bản hiện phải sử dụng tính năng Tìm kiếm bằng 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ính năng Tìm kiếm lân cận (Mới) đã thay đổi so với định dạng của các API cũ. Để biết thêm thông tin chi tiết, hãy xem phần 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 Tìm kiếm địa phương (Cũ) đã được đổi tên hoặc sửa đổi cho Tìm kiếm địa phương (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ú |
---|---|---|
keyword |
Không được hỗ trợ. Thay vào đó, hãy sử dụng tính năng Tìm kiếm văn bản (Mới). | |
language |
languageCode |
|
location |
locationRestriction |
Bắt buộc. |
maxprice/minprice |
|
Không được hỗ trợ. |
maxResultCount |
Thông số mới. | |
opennow |
|
Không được hỗ trợ. |
pagetoken |
Không được hỗ trợ. | |
radius |
|
Hãy sử dụng locationRestriction ngay. |
rankby |
rankPreference |
|
regionCode |
Thông số mới. | |
type |
includedTypes excludedTypes includedPrimaryTypes excludedPrimaryTypes
|
Các tham số mới cũng chấp nhận nhiều giá trị loại. API cũ chỉ chấp nhận một giá trị duy nhất. |
Yêu cầu mẫu
Yêu cầu GET mẫu sau đây sử dụng tính năng Tìm kiếm lân cậ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 thuộc loại restaurant
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/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 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. Ví dụ này cũng sử dụng 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