Brave Search Place Search

6积分/次
ae_bravesearch_place_search

按名称、类别或位置搜索商家及地标。可在 `q` 中填写名称或类别,使用 `location` 提供文字地点,或同时提供 `latitude` 和 `longitude` 指定中心点;省略 `q` 可探索指定区域。`radius`(米)用于让结果偏向中心附近,并非严格的距离筛选。结果可包含地点 ID、名称、坐标、地址,以及可用的电话、营业时间、评分和照片。地点 ID 约 8 小时内有效,可用于后续查询地点详情或 AI 生成的介绍。

地图
6积分/次

价格说明

6积分/次
条件费用
每次调用6积分/次

每次地点搜索调用固定收取6积分。

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
qstring否地点名称或类别,例如coffee shops;省略时探索指定区域。—
countinteger否最多返回的地点数。20
unitsenum (metric | imperial)否距离单位制。metric
radiusnumber否中心附近的搜索偏向,单位米;不是严格的范围过滤。—
countrystring否搜索市场的两字母国家代码,例如US。—
ui_langstring否界面语言地区代码,例如en-US。—
latitudenumber否中心纬度;与longitude一起提供。—
locationstring否地点文字,替代经纬度,例如san francisco ca united states或tokyo japan。—
longitudenumber否中心经度;与latitude一起提供。—
safesearchenum (off | moderate | strict)否安全搜索级别。strict
spellcheckboolean否是否纠正搜索词。true
search_langstring否搜索语言代码,例如en、zh-hans或zh-hant;不是zh-CN。—

调用示例

复制请求代码,查看对应的返回示例。

POST/agent-api/v1/tool/executeX-Api-Key
请求代码request.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_bravesearch_place_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "count": 3,
    "latitude": 37.7749,
    "longitude": -122.4194,
    "q": "coffee shops",
    "radius": 1000
  }
}'
返回示例response.json
JSON部分内容
{
  "location": {
    "coordinates": [
      37.77493
    ],
    "country": "US",
    "name": "San Francisco"
  },
  "mixed": [
    {
      "all": false,
      "index": 0,
      "type": "results"
    }
  ],
  "results": [
    {
      "categories": [
        "restaurant"
      ],
      "contact": {
        "telephone": "+16288677985"
      },
      "coordinates": [
        37.7733151
      ],
      "family_friendly": true,
      "id": "loc4MEADZ7P34JBEAOEU5O34BGS6YB7UOV4FAAAAAAA=",
      "title": "Doppio Coffee & Brunch"
    }
  ],
  "type": "locations"
}

返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。