Method: places.searchNearby

Tìm địa điểm gần các vị trí.

Yêu cầu HTTP

POST https://places.googleapis.com/v1/places:searchNearby

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "languageCode": string,
  "regionCode": string,
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ],
  "maxResultCount": integer,
  "locationRestriction": {
    object (LocationRestriction)
  },
  "rankPreference": enum (RankPreference)
}
Các trường
languageCode

string

Thông tin chi tiết về địa điểm sẽ được hiển thị bằng ngôn ngữ ưa thích, nếu có. Nếu mã ngôn ngữ không được chỉ định hoặc không nhận dạng được, thì hệ thống có thể trả lại thông tin chi tiết về địa điểm bằng bất kỳ ngôn ngữ nào, và ưu tiên sử dụng tiếng Anh nếu có.

Danh sách ngôn ngữ được hỗ trợ hiện tại: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Mã quốc gia/khu vực Unicode (CLDR) của vị trí nơi xuất phát yêu cầu. Tham số này dùng để hiển thị thông tin chi tiết về địa điểm, chẳng hạn như tên địa điểm theo khu vực cụ thể, nếu có. Thông số này có thể ảnh hưởng đến kết quả dựa trên luật hiện hành.

Để biết thêm thông tin, hãy xem https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Xin lưu ý rằng mã vùng gồm 3 chữ số hiện không được hỗ trợ.
includedTypes[]

string

Loại địa điểm có bao gồm (ví dụ: "nhà hàng" hoặc "trạm xăng") từ https://developers.google.com/maps/documentation/places/web-service/place-types.

Bạn có thể chỉ định tối đa 50 loại từ Bảng A.

Nếu có bất kỳ loại xung đột nào, tức là một loại xuất hiện trong cả bao gồm và loại trừ, thì lỗi INVALID_ biến sẽ được trả về.

Nếu một loại Địa điểm được chỉ định với nhiều hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các hạn chế mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["Developer"], excludedPrimaryTypes = ["Advertiser"]}, các địa điểm được trả về sẽ cung cấp các dịch vụ có liên quan đến "nhà hàng" nhưng không hoạt động chủ yếu dưới dạng "nhà hàng".
excludedTypes[]

string

Loại địa điểm bị loại trừ (ví dụ: "nhà hàng" hoặc "gas_station") khỏi https://developers.google.com/maps/documentation/places/web-service/place-types.

Bạn có thể chỉ định tối đa 50 loại từ Bảng A.

Nếu khách hàng cung cấp cả includeTypes (ví dụ: nhà hàng) và excludedTypes (ví dụ: quán cà phê) thì câu trả lời phải bao gồm các địa điểm là nhà hàng nhưng không phải là quán cà phê. Phản hồi bao gồm những địa điểm khớp với ít nhất một trong các includeTypes và không có các loại trừ.

Nếu có bất kỳ loại xung đột nào, tức là một loại xuất hiện trong cả bao gồm và loại trừ, thì lỗi INVALID_ biến sẽ được trả về.

Nếu một loại Địa điểm được chỉ định với nhiều hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các hạn chế mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["Developer"], excludedPrimaryTypes = ["Advertiser"]}, các địa điểm được trả về sẽ cung cấp các dịch vụ có liên quan đến "nhà hàng" nhưng không hoạt động chủ yếu dưới dạng "nhà hàng".
includedPrimaryTypes[]

string

Bao gồm Loại địa điểm chính (ví dụ: "nhà hàng" hoặc "gas_station") từ https://developers.google.com/maps/documentation/places/web-service/place-types. Một địa điểm chỉ có thể có một loại chính duy nhất từ bảng loại được hỗ trợ được liên kết với địa điểm đó.

Bạn có thể chỉ định tối đa 50 loại từ Bảng A.

Nếu có bất kỳ loại hình chính xung đột nào, tức là một loại xuất hiện trong cả includeprimaryTypes và excludedPrimaryTypes, thì lỗi INVALID_ hoa sẽ được trả về.

Nếu một loại Địa điểm được chỉ định với nhiều hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các hạn chế mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["Developer"], excludedPrimaryTypes = ["Advertiser"]}, các địa điểm được trả về sẽ cung cấp các dịch vụ có liên quan đến "nhà hàng" nhưng không hoạt động chủ yếu dưới dạng "nhà hàng".
excludedPrimaryTypes[]

string

Đã loại trừ Loại địa điểm chính (ví dụ: "nhà hàng" hoặc "gas_station") khỏi https://developers.google.com/maps/documentation/places/web-service/place-types.

Bạn có thể chỉ định tối đa 50 loại từ Bảng A.

Nếu có bất kỳ loại hình chính xung đột nào, tức là một loại xuất hiện trong cả includeprimaryTypes và excludedPrimaryTypes, thì lỗi INVALID_ hoa sẽ được trả về.

Nếu một loại Địa điểm được chỉ định với nhiều hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các hạn chế mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["Developer"], excludedPrimaryTypes = ["Advertiser"]}, các địa điểm được trả về sẽ cung cấp các dịch vụ có liên quan đến "nhà hàng" nhưng không hoạt động chủ yếu dưới dạng "nhà hàng".
maxResultCount

integer

Số lượng kết quả tối đa cần trả về. Giá trị này phải nằm trong khoảng từ 1 đến 20 (mặc định). Nếu bạn không đặt chính sách này, số này sẽ quay về giới hạn trên. Nếu số được đặt thành số âm hoặc vượt quá giới hạn trên, lỗi INVALID_ biến sẽ được trả về.
locationRestriction

object (LocationRestriction)

Bắt buộc. Khu vực tìm kiếm.
rankPreference

enum (RankPreference)

Cách xếp hạng kết quả trong câu trả lời.

Nội dung phản hồi

Proto phản hồi cho tính năng Tìm kiếm lân cận.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "places": [
    {
      object (Place)
    }
  ]
}
Các trường
places[]

object (Place)

Danh sách các địa điểm đáp ứng các yêu cầu của người dùng (như loại địa điểm, số lượng địa điểm và giới hạn cụ thể về vị trí).

LocationRestriction

Khu vực tìm kiếm.

Biểu diễn dưới dạng JSON 
{

  // Union field type can be only one of the following:
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Các trường

Trường nhóm type.

type chỉ có thể là một trong những trạng thái sau đây:
circle

object (Circle)

Một hình tròn được xác định bởi điểm giữa và bán kính.

RankPreference

Cách xếp hạng kết quả trong câu trả lời.

Enum
RANK_PREFERENCE_UNSPECIFIED Chưa đặt giá trị RankPreferences. Sẽ sử dụng thứ hạng theo POPULARITY theo mặc định.
DISTANCE Xếp hạng kết quả theo khoảng cách.
POPULARITY Xếp hạng kết quả theo mức độ phổ biến.