Method: places.searchNearby

Tìm kiế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),
  "routingParameters": {
    object (RoutingParameters)
  }
}
Trường
languageCode

string

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

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í nơi yêu cầu đến. 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 (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 đưa vào (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 trong Bảng A.

Nếu có bất kỳ loại nào xung đột, tức là một loại xuất hiện trong cả includedTypes và excludedTypes, 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 ta có {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, thì những địa điểm được trả về sẽ cung cấp các dịch vụ 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 "trạm_xăng") trên trang 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ả includedTypes (ví dụ: nhà hàng) và excludedTypes (ví dụ: quán cà phê), thì phản hồi phải bao gồm những địa điểm là nhà hàng nhưng không phải 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 includedTypes và không có địa điểm nào khớp với excludedTypes.

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

Nếu bạn chỉ định một loại Địa điểm có nhiều quy định hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các quy định hạn chế đó mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["nhà hàng"], excludedPrimaryTypes = ["nhà hàng"]}, thì các địa điểm được trả về cung cấp các dịch vụ 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

Đã thêm loại Địa điểm chính (ví dụ: "nhà_hàng" hoặc "trạm_xăng") 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 trong 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 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ả includePrimaryTypes và excludedPrimaryTypes, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Nếu bạn chỉ định một loại Địa điểm có nhiều quy định hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các quy định hạn chế đó mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["nhà hàng"], excludedPrimaryTypes = ["nhà hàng"]}, thì các địa điểm được trả về cung cấp các dịch vụ 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 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ả includedPrimaryTypes và excludedPrimaryTypes, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Nếu bạn chỉ định một loại Địa điểm có nhiều quy định hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các quy định hạn chế đó mới được trả về. Ví dụ: nếu chúng tôi có {includedTypes = ["nhà hàng"], excludedPrimaryTypes = ["nhà hàng"]}, thì các địa điểm được trả về cung cấp các dịch vụ 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ố 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), bao gồm cả hai giá trị này. Nếu bạn không đặt số này, thì số này sẽ quay lại giới hạn trên. Nếu số được đặt thành âm hoặc vượt quá giới hạn trên, 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.
routingParameters

object (RoutingParameters)

Không bắt buộc. Các tham số ảnh hưởng đến việc định tuyến đến kết quả tìm kiếm.

Nội dung phản hồi

Tệp 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)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ]
}
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, chẳng hạn như loại địa điểm, số lượng địa điểm và quy định hạn chế về vị trí cụ thể.
routingSummaries[]

object (RoutingSummary)

Danh sách bản tóm tắt định tuyến, trong đó mỗi mục nhập liên kết với vị trí tương ứng trong cùng một chỉ mục trong trường places. Nếu không có thông tin tóm tắt về tuyến đường cho một trong các địa điểm, thì thông tin tóm tắt đó sẽ chứa một mục trống. Danh sách này phải có số mục nhập bằng với danh sách địa điểm nếu được yêu cầu.

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 hợp hợp nhất 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ằng tâm điể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 đặt giá trị RankPreference. Sẽ sử dụng thứ hạng theo MỨC ĐỘ 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.