goplaces

goplaces 是什么

把 Google Places API New 封装为人类可读或 JSON 的命令行查询，用于找地点、查详情和读取评论。

适用场景

适合餐厅、门店、景点、地址和本地商户研究，也可为脚本或 Agent 提供结构化地点数据。

核心能力与工作机制

清单聚焦 text search、place details、resolve 与 reviews，并允许在友好文本和机器可读 JSON 之间选择。

执行流程

先明确地点关键词、城市或坐标与需要字段，配置 Google Places 凭据后调用对应子命令；脚本场景选择 JSON，并根据 place ID 继续查详情或评论。

输入与输出

需要搜索词、位置上下文或 place ID、Google Places API Key 和期望输出格式。输出候选地点、地址、坐标、营业信息、评分、详情或评论等 API 数据。

依赖、账号与权限

依赖 goplaces CLI、网络、启用 Places API 的 Google Cloud 项目和有效密钥，调用可能计费。

副作用、限制与风险

地点资料和营业状态可能滞后，评论具有主观性；位置查询会向 Google 发送搜索条件。会调用 Google Places 并消耗配额或费用，默认只读，不修改商家资料。

不适用边界

不能保证地点开放、价格、无障碍或安全状况，关键行程信息应向商家或官方确认。

失败处理与验收

无结果时增加城市、国家或坐标；认证、配额与字段错误分别检查密钥、账单和命令参数。用 place ID 去重，核对地址、电话、官网与更新时间，并对重要地点进行第二来源确认。

适合谁使用

适合旅行规划、本地生活研究、门店运营和需要地点 API 的开发者。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.0 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 25 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. goplaces 主要解决什么问题？

把 Google Places API New 封装为人类可读或 JSON 的命令行查询，用于找地点、查详情和读取评论。适合餐厅、门店、景点、地址和本地商户研究，也可为脚本或 Agent 提供结构化地点数据。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要搜索词、位置上下文或 place ID、Google Places API Key 和期望输出格式。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

先明确地点关键词、城市或坐标与需要字段，配置 Google Places 凭据后调用对应子命令；脚本场景选择 JSON，并根据 place ID 继续查详情或评论。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

依赖 goplaces CLI、网络、启用 Places API 的 Google Cloud 项目和有效密钥，调用可能计费。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

会调用 Google Places 并消耗配额或费用，默认只读，不修改商家资料。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

不能保证地点开放、价格、无障碍或安全状况，关键行程信息应向商家或官方确认。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

无结果时增加城市、国家或坐标；认证、配额与字段错误分别检查密钥、账单和命令参数。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

用 place ID 去重，核对地址、电话、官网与更新时间，并对重要地点进行第二来源确认。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。