goplaces

核心用法

goplaces 是一款面向 Google Places API (New) 的现代化命令行工具，提供人类可读的默认输出与 --json 机器解析格式。核心功能包括：文本搜索（goplaces search）、地点解析（goplaces resolve）、详情查询（goplaces details）及评论获取。支持地理位置偏置（经纬度+半径）、实时营业状态过滤、评分阈值筛选、价格等级过滤等高级参数，并具备分页能力处理大量结果。

显著优点

1. 双模式输出设计：默认彩色人类友好格式，加 --json 即可切换为脚本自动化所需的结构化数据，兼顾交互与工程场景。
2. 参数丰富灵活：支持 --open-now、、--min-rating、、--type 等多维过滤，以及 --lat//--lng//--radius-m 地理围栏，满足精准定位需求。
3. 安装便捷：通过 Homebrew 一键安装，依赖管理标准化，降低环境配置成本。
4. 功能覆盖完整：涵盖搜索、解析、详情、评论四大核心场景，基本满足地点信息查询的全链路需求。

潜在缺点与局限性

1. 外部依赖单一：核心功能完全依赖 goplaces 二进制文件，若上游停更或出现兼容性问题，Skill 将失效。
2. 类型过滤限制：--type 参数仅发送首个值（API 本身限制），复杂多类型筛选需多次调用。
3. 网络与地域限制：需稳定访问 Google Places API，部分网络环境可能无法使用；查询数据出境至 Google，存在合规考量。
4. 成本门槛：Google Places API 为付费服务（虽有免费额度），高频使用需关注账单。

适合的目标群体

• 开发者：需要快速验证地点数据、集成地理信息到脚本或 CI/CD 流程的工程师。
• 数据分析师：获取结构化 POI 数据用于市场研究、竞品分析或数据清洗。
• 终端效率用户：习惯命令行操作、需要快速查询周边商户信息的个人用户。

使用风险

1. API Key 泄露风险：GOOGLE_PLACES_API_KEY 为敏感凭证，硬编码或误提交至版本控制可能导致滥用与费用损失。
2. 依赖项维护风险：个人开发者维护的 CLI 工具（T3 来源）更新频率与长期支持存在不确定性。
3. 数据隐私风险：所有查询内容明文发送至 Google，敏感地点搜索可能暴露用户意图或商业机密。
4. 性能瓶颈：大规模分页查询或高并发调用可能触发 API 速率限制，需自行实现退避重试逻辑。