goplaces
现代化的 Google Places API CLI 工具,支持地点搜索、详细信息查询、地址解析及评论获取,可输出为人类易读格式或脚本使用的 JSON。
简介
goplaces 是一款专业的 CLI 工具,旨在简化 Google Places API (New) 的复杂端点操作,使其适应终端作业流程。专为需要进行地理空间查询、验证地点数据或自动化挖掘地点信息的开发者与高级用户而设计。无论您是在进行本地市场研究、为应用程序收集场地信息,还是编写自动化搜索脚本,goplaces 都能提供与 Google 庞大地点数据库交互的稳定且精简的接口。
-
执行基于文本的地点搜索,并可精确筛选营业状态、评分及结果数量。
-
将非结构化的地址或地点名称解析为具体的 Place ID 及地理坐标。
-
获取完整的地点详细信息,包含营业时间、地址组件及选择性的客户评论内容。
-
支持基于特定经纬度坐标及自定义半径的地理偏差(Bias)搜索。
-
提供人类易读的终端输出模式或原始 JSON 格式,方便整合至自动化工具、数据管道及 shell 脚本中。
-
支持通过分页标记(Page Token)进行分页,以高效处理大规模的搜索结果。
-
操作需具备有效的 GOOGLE_PLACES_API_KEY 环境变量。
-
支持通过 GOOGLE_PLACES_BASE_URL 设置进行代理或测试。
-
可通过 --no-color 参数或 NO_COLOR 环境变量停用 ANSI 色码,确保在 CI/CD 日志及非交互式环境中的兼容性。
-
处理标准 API 价格等级映射 (0-4),并严格遵守 Google Places API 文档规定的类型筛选限制。
-
用户可通过 macOS 或 Linux 上的 Homebrew 轻松安装,使其成为任何命令行工具组中便携且强大的扩展组件。
仓库统计
- Star 数
- 365,992
- Fork 数
- 75,039
- Open Issue 数
- 6,966
- 主要语言
- TypeScript
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年4月29日 05:28