什么是Goplaces
goplaces 是一个现代化的命令行工具，专为开发者设计，用于直接调用 Google Places API（新版）。它通过简洁的 CLI 接口提供对地点信息的快速访问，默认输出人类可读的格式，同时支持 JSON 模式以满足脚本自动化需求。该工具的核心优势在于其轻量级和易用性，无需复杂的配置即可集成到开发流程或日常查询中。用户只需设置环境变量 `GOOGLE_PLACES_API_KEY` 即可获得完整功能，非常适合需要快速获取地理位置数据的场景。无论是查找附近的咖啡店、验证地址信息，还是批量处理地点数据，goplaces 都能以高效的方式完成任务。 与传统的网页端 API 调用不同，goplaces 将 Google Places 的强大能力封装进终端环境中，使开发者能够在脚本、自动化任务或本地调试中无缝使用。它支持多种查询方式，包括文本搜索、基于坐标的范围筛选、分页浏览以及获取详细地点信息。此外，工具还提供了灵活的过滤选项，如营业时间、评分阈值、价格等级等，帮助用户精准定位目标地点。所有请求均遵循 Google Places API 的最新规范，确保数据准确性和接口稳定性。 尽管 goplaces 主要面向技术用户，但其清晰的输出格式和丰富的参数组合也使其成为非编程人员执行简单地理查询的理想选择。例如，用户可以通过一行命令快速列出当前附近评分高于4星且正在营业的餐厅，或将结果导出为结构化 JSON 供后续分析。工具的跨平台支持（通过 Homebrew 安装）进一步降低了使用门槛，使其在 macOS 及 Linux 环境下均可轻松部署。总体而言，goplaces 是一款兼具功能性、灵活性与实用性的命令行地理信息服务工具。
核心功能特点
- 支持 Google Places API（新版）的所有核心功能，包括文本搜索、地点详情、解析及评论获取
- 默认输出人性化易读的结果，同时可通过 `–json` 参数生成脚本友好的结构化数据
- 提供丰富的过滤选项，如营业时间 (`–open-now`)、最低评分 (`–min-rating`)、价格等级 (0–4) 和类型筛选
- 支持基于经纬度坐标的地理围栏搜索 (`–lat`, `–lng`, `–radius-m`) 和分页导航 (`–page-token`)
- 可通过环境变量 `GOOGLE_PLACES_API_KEY` 配置密钥，可选设置 `GOOGLE_PLACES_BASE_URL` 用于测试或代理
- 完全兼容 ANSI 色彩输出，支持 `–no-color` 或标准 `NO_COLOR` 环境变量关闭彩色显示
适用场景
goplaces 特别适合那些需要在命令行环境中快速查询或验证地理位置信息的开发者和技术用户。例如，在编写自动化脚本时，你可以使用 `goplaces search “coffee” –open-now –min-rating 4 –limit 5` 来获取当前附近营业中且评分较高的咖啡馆列表，并将结果以 JSON 格式保存用于进一步处理。这种能力在构建本地服务推荐系统、活动签到应用或旅行规划工具时尤为有用。另一个典型场景是地址解析：当你收到一个模糊的地点名称如 “Soho, London” 时，可以通过 `goplaces resolve “Soho, London” –limit 5` 快速确认其具体位置和唯一标识符（place_id），避免后续 API 调用错误。 对于运维人员或 DevOps 工程师来说，goplaces 可用于监控特定区域内的服务设施状态。比如定期检查某商圈内所有开放中的加油站，或在紧急情况下快速定位最近的医疗点。结合 cron 定时任务，还能实现无人值守的数据采集，生成日报或周报。此外，在数据分析项目中，利用 `–json` 输出可以方便地将地点信息导入数据库或可视化平台，进行热力图绘制、聚类分析等高级操作。 即使是非技术人员，也能受益于 goplaces 的直观命令行界面。市场调研员可以用它快速收集竞品门店分布；户外爱好者可查找徒步路线沿途的补给站；甚至普通用户在搬家前也能用它搜索新社区周边的超市、医院和公园。由于所有查询都基于权威的 Google Places 数据源，因此结果具有高可信度和实时性。无论是个人使用还是团队项目，goplaces 都能显著提升地点相关任务的效率与准确性。