Method: places.searchNearby

Tìm địa điểm gần 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)
}
Trường
languageCode

string

Thông tin chi tiết về địa điểm sẽ hiển thị cùng với ngôn ngữ ưu tiên (nếu có). Nếu mã ngôn ngữ không được xác định hoặc không nhận dạng được, thì hệ thống có thể trả về thông tin chi tiết về địa điểm của bất kỳ ngôn ngữ nào, trong đó ưu tiên tiếng Anh nếu có các chi tiết đó.

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

regionCode

string

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

Để biết thêm thông tin, hãy truy cập vào https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Xin lưu ý rằng mã vùng 3 chữ số hiện chưa được hỗ trợ.

includedTypes[]

string

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

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

Nếu có bất kỳ loại xung đột nào, tức là loại xuất hiện trong cả includeTypes và excludedTypes, lỗi INVALID_ARGUMENT 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ế này mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["Nhà hàng"], excludedPrimaryTypes = ["Nhà hàng"]}, thì địa điểm được trả về sẽ cho biết từ "nhà hàng" các dịch vụ có liên quan 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") trong https://developers.google.com/maps/documentation/places/web-service/place-types.

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

Nếu ứng dụng cung cấp cả loại include (ví dụ: nhà hàng) và loại trừ (ví dụ: quán cà phê), thì phản hồ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 các vị trí khớp với ít nhất một trong các loại include và không có loại nào bị loại trừ.

Nếu có bất kỳ loại xung đột nào, tức là loại xuất hiện trong cả includeTypes và excludedTypes, lỗi INVALID_ARGUMENT 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ế này mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["Nhà hàng"], excludedPrimaryTypes = ["Nhà hàng"]}, thì địa điểm được trả về sẽ cho biết từ "nhà hàng" các dịch vụ có liên quan 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") trong 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 trong bảng các loại được hỗ trợ liên kết với địa điểm đó.

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

Nếu có bất kỳ loại chính nào xung đột, tức là một loại xuất hiện trong cả bao gồmPrimaryTypes và excludedPrimaryTypes, thì lỗi INVALID_ARGUMENT 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ế này mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["Nhà hàng"], excludedPrimaryTypes = ["Nhà hàng"]}, thì địa điểm được trả về sẽ cho biết từ "nhà hàng" các dịch vụ có liên quan 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 trong Bảng A.

Nếu có bất kỳ loại chính nào xung đột, tức là một loại xuất hiện trong cả bao gồmPrimaryTypes và excludedPrimaryTypes, thì lỗi INVALID_ARGUMENT 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ế này mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["Nhà hàng"], excludedPrimaryTypes = ["Nhà hàng"]}, thì địa điểm được trả về sẽ cho biết từ "nhà hàng" các dịch vụ có liên quan nhưng không hoạt động chủ yếu dưới dạng "nhà hàng".

maxResultCount

integer

Số 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 con số này, thì con số đó 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, thì lỗi INVALID_ARGUMENT sẽ được trả về.

locationRestriction

object (LocationRestriction)

Bắt buộc. Khu vực cần 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ì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)
    }
  ]
}
Trường
places[]

object (Place)

Danh sách các địa điểm đáp ứng 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 vị trí cụ thể.

LocationRestriction

Khu vực cần 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.
}
Trường

Trường kết hợp type.

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

circle

object (Circle)

Hình tròn được xác định bởi tâm 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 thiết lập giá trị Xếp hạng. Sẽ sử dụng xếp hạng theo PHỔ BIẾN 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.