goplaces

• 您需要一个代理来查找附近的商家或兴趣点——例如"1公里范围内营业中的咖啡店，评分4星以上"
• 您希望将人类可读的地点名称（如"伦敦苏豪区"）解析为 Google Place ID，以供下游 API 调用使用
• 您需要将结构化的地点详情（营业时间、地址、评论）通过 JSON 输出传输到脚本或工作流中
• 您的代理必须按营业状态、价格等级、类型或地理半径筛选结果

• 您没有 Google Places API 密钥或无法获取密钥 — 没有它，goplaces 技能将无法正常运行
• 您需要地图渲染、导航路线或路径规划功能 — 本技能仅支持查询，不是完整的 Maps SDK
• 您需要批量或大规模的地点数据；标准 Google Places API 配额和计费规则适用

使用自然语言进行地点搜索，支持按营业状态、最低评分、价格等级、类型及结果数量进行筛选。示例：goplaces search "coffee" --open-now --min-rating 4 --limit 5。

将搜索结果偏向特定的经纬度位置，并将其限制在可配置的米制半径范围内，使基于位置的查询更加精准和相关。

使用 resolve 命令将人类可读的位置名称（例如"Soho, London"）转换为一个或多个 Google Place ID，从而无需手动查找 ID 即可进行后续详细信息查询。

通过 goplaces details <place_id> --reviews 获取任意地点 ID 的全面详情，包括用户评价。非常适合用权威的地点数据来丰富智能体的回复内容。

默认输出人性化的 ANSI 彩色文本以提高可读性，或使用 --json 切换为简洁的 JSON 格式，以便在脚本和自动化流水线中进行可靠解析。可通过 --no-color 选项或 NO_COLOR 环境变量禁用颜色输出。

通过 --page-token 支持多页结果集，允许代理迭代超出默认页面大小的大型结果列表。

一个帮助用户规划夜间外出的智能体，可以在特定街区内搜索评分较高且营业中的餐厅，按菜系类型和价格区间进行筛选，然后以易读的格式呈现最佳结果。

数据管道代理将模糊的位置字符串（例如城市区域、地标）解析为权威的 Google 地点 ID，然后将其传递给其他 API 调用或存储到数据库中。

正在调查某场所的智能体可通过 goplaces details <id> --reviews 直接获取其 Google Places 评论，从而在无需浏览器的情况下对情感倾向进行汇总或提取特定反馈。

一个批量自动化脚本使用 --json 输出，将商业名称列表与结构化地点数据（地址、评分、营业时间）进行enrichment，并将结果输送至下游处理工具。