Method: places.searchText

Tìm kiếm địa điểm dựa trên truy vấn văn bản.

Yêu cầu HTTP

POST https://places.googleapis.com/v1/places: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 có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "rankPreference": enum (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "pageSize": integer,
  "pageToken": string,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
Trường
textQuery

string

Bắt buộc. Truy vấn văn bản cho tìm kiếm bằng văn bản.
languageCode

string

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

Danh sách các 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í 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ó. Tham 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 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 gồm 3 chữ số hiện không được hỗ trợ.
rankPreference

enum (RankPreference)

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

string

Loại địa điểm được yêu cầu. Danh sách đầy đủ các loại được hỗ trợ: https://developers.google.com/maps/documentation/places/web-service/place-types. Chỉ hỗ trợ một loại đi kèm.
openNow

boolean

Dùng để hạn chế tìm kiếm trong các địa điểm hiện đang mở. Giá trị mặc định là "false".
minRating

number

Lọc ra kết quả có điểm xếp hạng trung bình từ người dùng hoàn toàn thấp hơn giới hạn này. Giá trị hợp lệ phải là một số thực từ 0 đến 5 (bao gồm) ở nhịp 0,5, tức là [0, 0,5, 1,0, ... , 5.0]. Giá trị đầu vào sẽ được làm tròn lên đến giá trị 0,5(trần) gần nhất. Ví dụ: điểm xếp hạng 0,6 sẽ loại bỏ tất cả kết quả có điểm xếp hạng thấp hơn 1,0.
maxResultCount
(deprecated)

integer

Không dùng nữa: Thay vào đó, hãy dùng pageSize.

Số lượng kết quả tối đa trên mỗi trang có thể trả về. Nếu số lượng kết quả có sẵn lớn hơn maxResultCount, thì nextPageToken sẽ được trả về và có thể truyền cho pageToken để lấy trang kết quả tiếp theo trong các yêu cầu tiếp theo. Nếu bạn cung cấp 0 hoặc không cung cấp giá trị thì giá trị mặc định là 20. Giá trị tối đa là 20; những giá trị trên 20 sẽ bị buộc thành 20. Giá trị âm sẽ trả về lỗi INVALID_ qu.

Nếu bạn chỉ định cả maxResultCount và pageSize, thì maxResultCount sẽ bị bỏ qua.
pageSize

integer

Không bắt buộc. Số lượng kết quả tối đa trên mỗi trang có thể trả về. Nếu số lượng kết quả có sẵn lớn hơn pageSize, thì nextPageToken sẽ được trả về và có thể truyền cho pageToken để lấy trang kết quả tiếp theo trong các yêu cầu tiếp theo. Nếu bạn cung cấp 0 hoặc không cung cấp giá trị thì giá trị mặc định là 20. Giá trị tối đa là 20; giá trị trên 20 sẽ được đặt thành 20. Giá trị âm sẽ trả về lỗi INVALID_ qu.

Nếu bạn chỉ định cả maxResultCount và pageSize, thì maxResultCount sẽ bị bỏ qua.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ lệnh gọi TextSearch trước đó. Cung cấp URL này để truy xuất trang tiếp theo.

Khi phân trang, mọi tham số ngoại trừ pageToken, pageSize và maxResultCount được cung cấp cho TextSearch phải khớp với lệnh gọi ban đầu đã cung cấp mã thông báo trang. Nếu không, hệ thống sẽ trả về lỗi INVALID_ qu.
priceLevels[]

enum (PriceLevel)

Dùng để giới hạn tìm kiếm trong những địa điểm được đánh dấu là mức giá nhất định. Người dùng có thể chọn bất kỳ tổ hợp mức giá nào. Mặc định chọn tất cả các mức giá.
strictTypeFiltering

boolean

Dùng để đặt chế độ lọc loại nghiêm ngặt cho includeType. Nếu bạn đặt chính sách này thành true (đúng), thì chỉ kết quả thuộc cùng loại mới được trả về. Mặc định là false.
locationBias

object (LocationBias)

Khu vực sẽ tìm kiếm. Vị trí này đóng vai trò là một thiên có nghĩa là các kết quả xung quanh vị trí đã cho có thể được trả về. Không thể đặt cùng với locationRestriction.
locationRestriction

object (LocationRestriction)

Khu vực sẽ tìm kiếm. Vị trí này đóng vai trò là một quy định hạn chế có nghĩa là sẽ không trả về các kết quả bên ngoài vị trí nhất định. Không thể đặt cùng với locationBias.
evOptions

object (EVOptions)

Không bắt buộc. Đặt các chế độ xe điện có thể tìm kiếm của một yêu cầu tìm kiếm địa điểm.

Nội dung phản hồi

Proto của phản hồi cho places.searchText.

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)
    }
  ],
  "contextualContents": [
    {
      object (ContextualContent)
    }
  ],
  "nextPageToken": string
}
Trường
places[]

object (Place)

Danh sách các địa điểm đáp ứng tiêu chí tìm kiếm bằng văn bản của người dùng.
contextualContents[]

object (ContextualContent)

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Danh sách nội dung theo ngữ cảnh mà mỗi mục nhập liên kết với địa điểm tương ứng trong cùng một chỉ mục trong trường địa điểm. Ưu tiên nội dung có liên quan đến textQuery trong yêu cầu. Nếu nội dung theo ngữ cảnh không có sẵn cho một trong các địa điểm, nội dung đó sẽ trả về nội dung không theo ngữ cảnh. Trường này sẽ chỉ trống khi không có nội dung về địa điểm này. Danh sách này phải có nhiều mục nhập như danh sách các địa điểm nếu được yêu cầu.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua hoặc trống thì không có trang tiếp theo.

RankPreference

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

Enum
RANK_PREFERENCE_UNSPECIFIED Đối với cụm từ tìm kiếm theo danh mục, chẳng hạn như "Nhà hàng ở thành phố New York", RELEVANCE là giá trị mặc định. Đối với các cụm từ tìm kiếm không phân loại, chẳng hạn như " Mountain View, CA", bạn nên không đặt RankPreferences.
DISTANCE Xếp hạng kết quả theo khoảng cách.
RELEVANCE Xếp hạng kết quả theo mức độ liên quan. Thứ tự sắp xếp được xác định theo thứ tự xếp hạng thông thường.

LocationBias

Khu vực sẽ tìm kiếm. Vị trí này đóng vai trò là một thiên có nghĩa là các kết quả xung quanh vị trí đã cho có thể được trả về.

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

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Trường

Trường hợp type.

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

object (Viewport)

Một hộp hình chữ nhật được xác định theo góc đông bắc và tây nam. rectangle.high() phải là điểm phía đông bắc của khung nhìn hình chữ nhật. rectangle.low() phải là điểm phía tây nam của khung nhìn hình chữ nhật. rectangle.low().latitude() không được lớn hơn rectangle.high().latitude(). Thao tác này sẽ dẫn đến một phạm vi vĩ độ trống. Khung nhìn hình chữ nhật không được rộng hơn 180 độ.
circle

object (Circle)

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

LocationRestriction

Khu vực sẽ tìm kiếm. Vị trí này đóng vai trò là một quy định hạn chế có nghĩa là sẽ không trả về các kết quả bên ngoài vị trí nhất định.

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

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Trường

Trường hợp type.

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

object (Viewport)

Một hộp hình chữ nhật được xác định theo góc đông bắc và tây nam. rectangle.high() phải là điểm phía đông bắc của khung nhìn hình chữ nhật. rectangle.low() phải là điểm phía tây nam của khung nhìn hình chữ nhật. rectangle.low().latitude() không được lớn hơn rectangle.high().latitude(). Thao tác này sẽ dẫn đến một phạm vi vĩ độ trống. Khung nhìn hình chữ nhật không được rộng hơn 180 độ.

EVOptions

Các lựa chọn xe điện có thể tìm kiếm của một yêu cầu tìm kiếm địa điểm.

Biểu diễn dưới dạng JSON 
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
Trường
minimumChargingRateKw

number

Không bắt buộc. Tốc độ sạc tối thiểu bắt buộc tính bằng kilowatt. Một địa điểm có tốc độ sạc thấp hơn tốc độ đã chỉ định sẽ bị lọc ra.
connectorTypes[]

enum (EVConnectorType)

Không bắt buộc. Danh sách các loại đầu nối xe điện được ưa thích. Vị trí không hỗ trợ bất kỳ loại trình kết nối nào được liệt kê sẽ bị lọc ra.

ContextualContent

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Nội dung theo ngữ cảnh đối với cụm từ tìm kiếm về địa điểm.

Biểu diễn dưới dạng JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "justifications": [
    {
      object (Justification)
    }
  ]
}
Trường
reviews[]

object (Review)

Danh sách các bài đánh giá về địa điểm này, ngoại trừ cụm từ tìm kiếm về địa điểm.
photos[]

object (Photo)

Thông tin (bao gồm cả nội dung tham khảo) về ảnh của địa điểm này, liên quan đến cụm từ tìm kiếm về địa điểm.
justifications[]

object (Justification)

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Lý do cho địa điểm.

Lý giải

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Lý do cho địa điểm. Lý do giải đáp cho câu hỏi tại sao một địa điểm có thể thu hút người dùng cuối.

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

  // Union field justification can be only one of the following:
  "reviewJustification": {
    object (ReviewJustification)
  },
  "businessAvailabilityAttributesJustification": {
    object (BusinessAvailabilityAttributesJustification)
  }
  // End of list of possible types for union field justification.
}
Trường

Trường hợp justification.

justification chỉ có thể là một trong những trạng thái sau:
reviewJustification

object (ReviewJustification)

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

ReviewJustification

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Lý do của bài đánh giá của người dùng. Thao tác này sẽ làm nổi bật một phần trong bài đánh giá của người dùng mà người dùng cuối sẽ quan tâm. Ví dụ: nếu cụm từ tìm kiếm là "bánh pizza củi", thì lý do đánh giá sẽ tô sáng phần văn bản có liên quan đến cụm từ tìm kiếm.

Biểu diễn dưới dạng JSON 
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
Trường
highlightedText

object (HighlightedText)
review

object (Review)

Bài đánh giá dùng để tạo văn bản được đánh dấu.

HighlightedText

Văn bản được làm nổi bật bên cạnh phần giải thích. Đây là một phần trong quá trình đánh giá. Từ chính xác cần làm nổi bật được đánh dấu bằng HighlightedTextRange. Văn bản có thể có một số từ đang được đánh dấu.

Biểu diễn dưới dạng JSON 
{
  "text": string,
  "highlightedTextRanges": [
    {
      object (HighlightedTextRange)
    }
  ]
}
Trường
text

string
highlightedTextRanges[]

object (HighlightedTextRange)

Danh sách các dải văn bản được đánh dấu.

HighlightedTextRange

Dải ô của văn bản được đánh dấu.

Biểu diễn dưới dạng JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Trường
startIndex

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết. Lý do của Business tứcAttributes. Biểu đồ này cho thấy một số đặc điểm của doanh nghiệp có thể thu hút người dùng cuối.

Biểu diễn dưới dạng JSON 
{
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean
}
Trường
takeout

boolean

Nếu một địa điểm cung cấp đồ ăn mang đi.
delivery

boolean

Nếu một địa điểm có cung cấp dịch vụ giao hàng.
dineIn

boolean

Nếu một địa điểm cung cấp dịch vụ ăn uống.