地点查询CLI

技能简介

goplaces 是 Google Places API (New) 的命令行封装工具，支持文本搜索、地点详情、地址解析和评论获取。默认输出人类可读格式，也可通过 --json 参数获取结构化数据供脚本调用。

能做什么

• 按关键词搜索附近地点，支持营业时间、评分、价格筛选
• 根据经纬度坐标限定搜索范围
• 解析模糊地址为具体地点列表
• 获取指定地点的详细信息和用户评论
• 输出标准 JSON 格式便于自动化处理

使用说明

1. 安装 goplaces

brew install steipete/tap/goplaces

2. 配置环境变量

export GOOGLE_PLACES_API_KEY="your_api_key_here"

可选：设置 GOOGLE_PLACES_BASE_URL 用于测试或代理场景。

3. 常用操作示例

搜索营业中且评分4分以上的咖啡店（最多5条）：

goplaces search "coffee" --open-now --min-rating 4 --limit 5

以指定坐标为中心、半径3公里内搜索披萨店：

goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000

解析地址并获取候选结果：

goplaces resolve "Soho, London" --limit 5

获取地点详情及评论：

goplaces details <place_id> --reviews

获取 JSON 格式输出：

goplaces search "sushi" --json

4. 其他选项

• --no-color 或环境变量 NO_COLOR 关闭彩色输出
• 价格等级：0（免费）到 4（非常昂贵）
• --type 参数仅接受第一个值（API 限制）

输入与输出

见下方输入与输出表格。

项目	内容
输入	搜索关键词、经纬度坐标、搜索半径、分页令牌、地点ID；环境变量 GOOGLE_PLACES_API_KEY（必需）
输出	地点名称、地址、地理坐标、营业时间、评分、价格等级、用户评论；支持纯文本或 JSON 格式
适用人群	开发者、运维人员、数据工程师、偏好 CLI 的技术用户
不包含	图形界面、路线导航、实时路况、室内地图、自动翻译功能

 

风险提示

• 需自行申请并保管 Google Places API 密钥，避免泄露
• API 调用按量计费，注意使用配额和成本
• 地点类型过滤仅支持单一值，多次指定会被忽略
• 分页令牌有过期时间，需及时使用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/steipete/goplaces/SKILL.md
来源类型：GitHub 仓库