Di chuyển sang Tìm kiếm lân cận (Mới)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Giới thiệu

Places API hỗ trợ Nearby Search (Cũ). Nếu bạn đã quen thuộc với Nearby Search (Cũ), thì Nearby Search (Mới) sẽ có những 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 HTTP POST. Truyền tham số trong 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 HTTP. Ngược lại, với Nearby Search (Cũ), bạn truyền các Tham số URL bằng yêu cầu GET HTTP.
  • Bạn phải cung cấp mặt nạ trường. Bạn phải chỉ định những trường mà bạn muốn trả về trong phản hồi. Không có danh sách mặc định cho 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 FieldMask.
  • Nearby Search (Mới) hỗ trợ cả khoá API và mã thông báo OAuth làm cơ chế xác thực.
  • Chỉ JSON được hỗ trợ dưới dạng định dạng phản hồi trong Nearby Search (Mới).
  • Giờ đây, tất cả yêu cầu có chứa cụm từ tìm kiếm dạng văn bản đều phải sử dụng Tìm kiếm văn bản (Mới) vì tính năng Nearby Search (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 Nearby Search (Mới) đã thay đổi so với định dạng của các API cũ. Để biết thêm thông tin, hãy xem bài viết Di chuyển phản hồi của Places API.

Bảng sau đây liệt kê các tham số trong Nearby Search (Cũ) đã được đổi tên hoặc sửa đổi cho Nearby Search (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ì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 Tham số mới.
opennow Không được hỗ trợ.
pagetoken Không được hỗ trợ.
radius Sử dụng locationRestriction ngay.
rankby rankPreference
regionCode Tham 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

Ví dụ sau đây về yêu cầu GET 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ả 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 Nearby Search (Mới), bạn gửi một yêu cầu POST và truyền tất cả tham số trong phần nội dung yêu cầu JSON hoặc trong tiêu đề dưới dạng 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