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,
  "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

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. Giá trị mặc định là 20. Nếu bạn không đặt số, thì nó 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, hệ thống sẽ trả về lỗi INVALID_ mở.
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)
    }
  ]
}
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.

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.