Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。
可用的 Google Maps API
使用 Search 按 query 与 location 发现地点，使用 Place Details 处理已知 Maps URL，使用 Reviews 采集数量受控的公开评价。
可以获取哪些 Google Maps 数据？
SocQ 返回标准化公开 PlaceItem 记录，可用于地点研究、商家发现、数据补全和时点市场快照。
地点身份
获取可用的地点 ID、名称、分类、来源 URL、记录类型和采集时间。
地址与地理上下文
保留可用的格式化地址、位置标签、城市、地区、国家、纬度和经度。
公开联系方式
在搜索结果提供时采集公开电话号码和网站。
评分与评价数
保留来源报告的可用评分与评价数量，不推断缺失值。
说明与分类
使用可用摘要文字和分类标签对地点结果进行分类与筛选。
任务与分页元数据
跟踪任务状态与 result_count，再通过 next_cursor 和 has_more 分页读取已存储的 PlaceItem 记录。
location 文本与坐标上下文
Google Maps Search 始终要求 query 和 location。当前 runtime 契约中，坐标是可选上下文，不能替代 location。
| 输入方式 | runtime 行为 | 适用情况 |
|---|---|---|
| 仅 location | location 文本与 query 组合用于地点发现 | 按城市、街区、地标或地址搜索 |
| location 加两个坐标 | location 仍为必填，坐标分别作为 lat 和 long 传递 | 已有可靠的地理中心 |
| location 加一个坐标 | 已提供的坐标会独立传递 | 仅在刻意使用部分地理上下文时采用 |
| country 与 zoom_level | 可选上下文随搜索行传递 | 请求需要国家提示或 0 到 21 的明确缩放级别 |
Google Maps API 如何工作
提交数量受控的地点搜索，等待异步采集，再分页读取为任务存储的标准化记录。
1. 定义地点搜索
选择明确 query 与必填 location，并且只增加真正需要的可靠可选地理上下文。
2. 提交并跟踪任务
发送 POST 请求，保存 task_id，并轮询 /v1/tasks/{task_id} 直到处理成功或失败。
3. 读取标准化地点
处理 data.results.items，并在 has_more 为 true 时继续使用 next_cursor。
提交 query、location 与较小的结果上限，再通过共享任务接口读取标准化 PlaceItem 结果。
curl -X POST "https://api.socq.ai/v1/google-maps/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"coffee","location":"New York, NY","country":"US","results_limit":3}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor常见 Google Maps API 使用场景
发现本地商家
在城市、街区、地标或地址上下文中查找匹配某个分类或服务的公开商家。
补全地点数据
为已有地点候选增加可用的联系方式、地址、分类、评分、评价数、URL 和坐标字段。
地理市场快照
为独立提交的区域采集数量受控结果集，并对比特定采集时间的公开地点覆盖。
地点核对队列
根据公开身份、联系信息、评分和地理字段准备候选清单，以便后续审核或单独获取详情。
限制与公开数据边界
结果是采集时的公开记录。搜索可用性和字段完整度取决于来源针对提交请求公开的内容。
- query 和 location 都是必填非空字符串；坐标不能替代 location。
- country、latitude、longitude 和 zoom_level 为选填；当前 runtime 允许 latitude 与 longitude 独立提供。
- zoom_level 必须是 0 到 21 的整数；results_limit 默认值为 100，可设置为 1 到 2,000。
- results_limit 是采集上限，而任务 GET 的 limit 控制每个响应页返回多少条已存储结果。
- 公开结果可能缺少说明、分类、联系方式、评分、评价数、URL 或地理子字段。
- 公开身份重复的记录在同一任务中只存储一次，因此 result_count 可能少于观察到的来源行数。
Google Maps API 常见问题
Google Maps API 是什么？
Google Maps APIs 通过异步任务搜索公开地点、解析已知地点 URL，并采集公开评价。Search 接收 query 与 location，并以标准化 PlaceItem 记录返回可用身份、地址、联系方式、评分、评价数、URL 和坐标字段。
Search 要求哪些输入？
Search 要求非空 query 与 location。country、latitude、longitude、zoom_level 和 results_limit 是选填字段。
采集上限与响应分页有什么区别？
results_limit 限制本次搜索采集的记录数。任务成功后，任务接口使用独立的 limit 和 next_cursor 参数对已存储记录分页返回。
为什么地点字段可能为 null？
公开搜索结果不一定提供全部联系方式、评分、评价、说明、URL、地址或坐标字段。标准化 schema 会把这些缺失值保留为 null。
Google Maps Search 结果如何计费？
每条已存储地点消耗 0.15 积分。预扣估算使用 results_limit，省略时使用 100；成功后按实际已存储结果数结算。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Google Play API
通过已知商店链接采集公开 Google Play 应用详情、分类榜单和评价，并返回标准化应用与评价记录。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
LinkedIn API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。
Reddit API
通过已知 URL 获取公开 Reddit 帖子和评论，浏览 subreddit 中的 new、top 或 hot 帖子，或按关键词和发布时间搜索讨论。
Rednote API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。