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 ( |
Trường | |
---|---|
languageCode |
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 |
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[] |
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[] |
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[] |
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[] |
Đã 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 |
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 |
Bắt buộc. Khu vực cần tìm kiếm. |
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 ( |
Trường | |
---|---|
places[] |
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 |
Trường | |
---|---|
Trường kết hợp
|
|
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. |