SearchTextRequest

SearchText 的请求消息。

JSON 表示法
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
字段
textQuery

string

必需。文本查询。

languageCode

string

可选。请求返回摘要时使用的语言。如果语言代码未指定或无法识别,系统会返回摘要,并优先使用英语。

例如,“en”表示英语。

当前支持的语言列表:https://developers.google.com/maps/faq#languagesupport。

regionCode

string

可选。请求来源位置的 Unicode 国家/地区代码 (CLDR)。此参数用于显示地点详情,例如特定于区域的地点名称(如果有)。该参数可能会根据适用法律影响结果。

例如,"US" 表示美国。

如需了解详情,请参阅 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

请注意,目前不支持 3 位数的地区代码。

pageSize

integer

可选。要返回的地点数量上限,最多 10 个。服务返回的值可能小于此值。该默认值为 5。

请求超过 5 个地点会触发 Pro 层级,并产生更高的结算费用和延迟时间。

includeExtendedDetails

boolean

可选。在响应中包含扩展的地点详情。

当用户请求需要丰富的定性数据洞见、实时动态或专门的实体属性时,请将此字段设置为 true:- 定性评价、客户情绪和反馈。- 具体产品/服务,例如菜单项、菜品、特色美食、饮品或商家亮点。- 氛围、室内装饰、美学、环境或情调等定性描述。- 实时数据和专门设施规格、访客政策/提示、等待时间。

对于标准发现搜索(例如菜系、商店类型)、位置/地址查询、联系信息、营业时间和标准元数据/设施,请保留 false(默认)。

启用此字段会触发 Pro 层级,并产生更高的结算费用和更长的延迟时间。

locationBias

object (LocationBias)

一个可选区域,用于使搜索结果偏向于该区域。如果 textQuery 中有明确的位置,则系统会使用该位置(而非此字段)来调整搜索结果。

LocationBias

搜索结果偏向的区域。系统可能仍会返回此区域以外的地点。

JSON 表示法
{
  "circle": {
    object (Circle)
  }
}
字段
circle

object (Circle)

可选。由中心点和半径定义的圆形。radiusMeters 是可选设置,如果未设置,结果将偏向中心点。

圆形

由中心点和半径定义的圆形。

JSON 表示法
{
  "center": {
    object (LatLng)
  },
  "radiusMeters": number
}
字段
center

object (LatLng)

必需。圆形的中心点。

radiusMeters

number

圆形的半径(以米为单位)。半径必须在 50,000 米以内。