Method: searchText

Tìm kiếm địa điểm bằng cụm từ tìm kiếm dạng văn bản.

Yêu cầu HTTP

POST https://mapstools.googleapis.com/v1alpha:searchText

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 với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
Trường
textQuery

string

Bắt buộc. Cụm từ tìm kiếm dạng văn bản.
languageCode

string

Không bắt buộc. Ngôn ngữ mà bạn muốn nhận bản tóm tắt. Nếu mã ngôn ngữ không được chỉ định hoặc không được nhận dạng, thì bản tóm tắt ưu tiên tiếng Anh sẽ được trả về.

Ví dụ: "en" cho tiếng Anh.

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

string

Không bắt buộc. Mã quốc gia/khu vực Unicode (CLDR) của vị trí nơi yêu cầu được đưa ra. Tham số này được dùng để hiển thị Place Details, chẳng hạn như tên địa điểm theo khu vực cụ thể (nếu có). Tham số này có thể ảnh hưởng đến kết quả dựa trên luật hiện hành.

Ví dụ: "US" cho Hoa Kỳ.

Để 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 chưa được hỗ trợ.
pageSize

integer

Không bắt buộc. Số lượng địa điểm tối đa cần trả về, tối đa là 10. Dịch vụ có thể trả về ít hơn giá trị này. Giá trị mặc định là 5.

Nếu bạn yêu cầu hơn 5 địa điểm, thì cấp Pro sẽ được kích hoạt, đồng thời chi phí thanh toán và độ trễ sẽ tăng lên.
includeExtendedDetails

boolean

Không bắt buộc. Bao gồm thông tin chi tiết mở rộng về Place Details trong phản hồi.

Đặt trường này thành true khi yêu cầu của người dùng cần có thông tin chi tiết định tính phong phú, thông tin linh động theo thời gian thực hoặc thuộc tính thực thể chuyên biệt: – Bài đánh giá định tính, cảm nhận của khách hàng và ý kiến phản hồi. – Các sản phẩm/dịch vụ cụ thể như món trong thực đơn, món ăn, món đặc sản, đồ uống hoặc điểm nổi bật của doanh nghiệp. – Bầu không khí, phong cách trang trí nội thất, tính thẩm mỹ, không gian hoặc tâm trạng chất lượng. – Dữ liệu theo thời gian thực và thông số kỹ thuật của cơ sở chuyên khoa, chính sách/mẹo dành cho khách, thời gian chờ.

Để trống false (mặc định) cho các cụm từ tìm kiếm khám phá thông thường (ví dụ: ẩm thực, loại cửa hàng), thông tin tra cứu vị trí/địa chỉ, thông tin liên hệ, giờ hoạt động và siêu dữ liệu/tiện nghi thông thường.

Khi bạn bật trường này, mô hình Gemini Pro sẽ được kích hoạt, dẫn đến chi phí được lập hoá đơn cao hơn và độ trễ lớn hơn.
locationBias

object (LocationBias)

Một khu vực không bắt buộc để ưu tiên kết quả tìm kiếm. Nếu một vị trí rõ ràng nằm trong textQuery, thì vị trí đó sẽ được dùng để thiên vị kết quả tìm kiếm thay vì trường này.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của SearchTextResponse.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/maps-platform.mapstools