Skip to main content
POST
Google 地图 Places

Google 地图 Places

获取 Google 地图 的标准化公开 Places 数据。 每个非空提交 URL 预留 0.15 积分。任务按每条成功返回的标准结果 0.15 积分结算,并退回未使用的预留积分。

请求体

请求限制

  • urls 为必填字段,必须包含至少一个非空字符串;该接口不接受 results_limit
  • 每个值都必须能解析出 google.comgoo.gl 或两者子域名的 hostname。包含 authority 和 hostname 时可使用任意 scheme,同时支持协议相对地址。
  • 运行时不要求 /maps/place 等特定路径;内部结果上限等于提交的非空 URL 数量。

通过 MCP 使用

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

结果字段

任务完成响应

授权

Authorization
string
header
必填

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

请求体

application/json
urls
string[]
必填

非空地址列表,解析后的主机名必须为 google.com、goo.gl 或两者的子域名;包含 authority 和 hostname 时可使用任意 scheme,同时支持协议相对地址,且不要求特定路径,至少提供 1 项。

Minimum string length: 1

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object