研究
goplaces avatar

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
在 GitHub 查看