spots

核心用法

spots 是一款基于网格扫描技术的 Google Places 增强搜索工具。不同于常规搜索仅返回 Google 算法推荐的有限结果，它通过将目标区域划分为细密网格、逐格调用 Places API 的方式，实现穷尽式地理信息采集。

主要功能

• 坐标/地名双模式搜索：支持直接输入经纬度或地理位置名称
• 多维度过滤：按评分（--min-rating）、评论数（--min-reviews）、营业状态（--open-now）筛选
• 导出多样化：JSON/CSV 数据导出或生成可视化 HTML 地图
• 独立评论获取：支持单独拉取特定商家的完整评价数据

显著优点

• 数据完整性：破解 Google 默认仅展示前20-60条的限制，理论上可获取半径内全部POI
• 精准定位：网格扫描避免热门区域结果被算法过度过滤
• 即开即用：单二进制文件，支持 go install 快速部署
• 工作流友好：1Password 密钥集成、Telegram 位置分享直连

潜在缺点与局限

• API 成本：高密度网格扫描消耗大量 Places API 配额，大规模搜索成本高昂
• 速率限制：需自行管理 Google Cloud 配额与并发策略
• 数据时效：依赖 Google 数据库更新频率，非实时数据
• 覆盖盲区：仅限 Google 已收录商家，新兴/未上线店铺无法获取

适合人群

• 餐饮创业者选址调研
• 本地生活产品经理竞品分析
• 城市研究者/数据记者
• 旅行规划深度用户

常规风险

• API 密钥泄露：需妥善保管 GOOGLE_PLACES_API_KEY，建议使用 1Password 等密钥管理工具
• 合规边界：商业用途需确认 Google Places API 服务条款，大规模爬取可能触发风控
• 隐私敏感：导出含地理位置的公开商家数据一般合规，但需避免与个人信息关联分析

核心用法

spots 是一个命令行工具，通过网格化扫描技术突破 Google Places 的常规搜索结果限制，发现算法未优先展示的本地店铺。支持两种定位方式：地名搜索（如"Arnhem Centrum"）或精确坐标（-c 51.9817,5.9093），典型工作流为设定半径范围（-r 米）、筛选关键词（-q）、过滤评分（--min-rating），最终输出 JSON/CSV 或可交互的 HTML 地图。

显著优点

1. 发现盲区店铺：网格扫描机制能捕获 Google 默认排序中靠后的独立咖啡馆、家庭面包坊等长尾商户，对城市探索者和本地生活博主极具价值。
2. 灵活的地理位置输入：支持从 Telegram 等应用直接粘贴坐标，无需手动转换地址。
3. 开箱即用的可视化：-o map 一键生成独立 HTML 文件，内置地图标记，便于离线分享或嵌入博客。
4. 轻量无依赖：纯 Go 编写，单二进制文件部署，配合 API Key 即可运行。

潜在局限

1. Google API 成本：Places API 与 Geocoding API 调用按量计费，高频网格扫描可能产生意外账单，需提前配置配额警报。
2. 数据实时性依赖上游：店铺营业状态、评分变动完全依赖 Google 数据更新，存在 24-48 小时延迟。
3. 无内置缓存：重复搜索相同区域会重复计费，未提供本地数据库层。
4. T3 来源维护风险：个人开发者维护，长期更新承诺不确定。

适合人群

• 旅行规划者寻找非主流餐饮选项
• 本地内容创作者构建城市探店数据库
• 开发者集成至自动化工作流（配合 -o json）

常规风险

• API Key 泄露风险：命令行历史或脚本中可能意外暴露 GOOGLE_PLACES_API_KEY
• 建议配合 1Password CLI 等凭据管理工具注入密钥，避免明文存储