Skip to main content
POST
Google 地图 Search

Google 地图 Search

获取 Google 地图 的标准化公开 Search 数据。 成功返回的每条标准结果扣除 0.15 积分。列表接口按 results_limit 预扣并按实际结果结算。

请求体

请求限制

  • querylocation 是必填字符串;countrylatitudelongitudezoom_levelresults_limit 为选填字段。
  • latitudelongitude 是彼此独立的数值输入;当前运行时只校验其数值类型,不限制数值范围。
  • zoom_level 必须是 021 的整数。
  • results_limit 必须是 12,000 的整数,默认值为 100

通过 MCP 使用

请求成功后会返回 task_id。使用 socq_get_task 查询任务,成功后从 results.items 读取标准化结果。

结果字段

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json
location
string
必填

请求参数。

Minimum string length: 1
query
string
必填

搜索关键词。

Minimum string length: 1
country
string

国家或地区筛选条件。

Minimum string length: 1
latitude
number

可选的纬度数值;当前运行时只校验其为数值,不限制数值范围。

必填范围: -90 <= x <= 90
longitude
number

可选的经度数值;当前运行时只校验其为数值,不限制数值范围。

必填范围: -180 <= x <= 180
results_limit
integer
默认值:100

最多保存的结果数,实际结果可能少于该值。

必填范围: 1 <= x <= 2000
zoom_level
integer

请求参数。

必填范围: 0 <= x <= 21

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object