Google 地点查询终端利器

基于 Google Places API 的现代化 CLI 工具，支持地点搜索、详情查询与评论获取，需用户自行配置 API Key，适合开发者与终端用户快速获取结构化地理信息。

基本信息

• 技能名称?goplaces
• 中文名称?Google 地点查询终端利器
• 作者?steipete
• 分类?效率
• 版本?v1.0.0
• 标签?api, data-analytics, productivity, development-engineering, automation

使用方法

使用说明
核心用法
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. 功能覆盖完整 ：涵盖搜索、解析、详情、评论四大核心场景，基本满足地点信息查询的全链路需求。
   潜在缺点与局限性
5. 外部依赖单一 ：核心功能完全依赖 goplaces 二进制文件，若上游停更或出现兼容性问题，Skill 将失效。
6. 类型过滤限制 ： --type 参数仅发送首个值（API 本身限制），复杂多类型筛选需多次调用。
7. 网络与地域限制 ：需稳定访问 Google Places API，部分网络环境可能无法使用；查询数据出境至 Google，存在合规考量。
8. 成本门槛 ：Google Places API 为付费服务（虽有免费额度），高频使用需关注账单。
   适合的目标群体
   开发者 ：需要快速验证地点数据、集成地理信息到脚本或 CI/CD 流程的工程师。
   数据分析师 ：获取结构化 POI 数据用于市场研究、竞品分析或数据清洗。
   终端效率用户 ：习惯命令行操作、需要快速查询周边商户信息的个人用户。
   使用风险
9. API Key 泄露风险 ： GOOGLE_PLACES_API_KEY 为敏感凭证，硬编码或误提交至版本控制可能导致滥用与费用损失。
10. 依赖项维护风险 ：个人开发者维护的 CLI 工具（T3 来源）更新频率与长期支持存在不确定性。
11. 数据隐私风险 ：所有查询内容明文发送至 Google，敏感地点搜索可能暴露用户意图或商业机密。
12. 性能瓶颈 ：大规模分页查询或高并发调用可能触发 API 速率限制，需自行实现退避重试逻辑。