核心功能与用法
places 技能是 Claude Code 的地理定位工具,基于 Camino AI 的 /search API 实现。它提供两种查询模式:自由文本搜索(如「埃菲尔铁塔」)和结构化地址组件(街道、城市、邮编等),可将地址转换为精确的经纬度坐标(地理编码),同时返回地点类型、重要性评分等元数据。可选参数 include_photos 可获取街景级影像,mode: "advanced" 则提供网络增强的 richer 数据。
显著优点
1. 灵活的查询方式:既支持口语化地标名称,也支持精确地址拆分,降低用户输入门槛。
2. 结构化响应:返回标准 JSON 格式,包含 display_name、lat/lon、address 嵌套对象,便于下游处理。
3. 视觉增强:可选街景照片为地点验证提供视觉上下文,优于纯文本地理编码服务。
4. 与 `/query` 技能互补:官方明确区分 places(精确地理编码/地点查找)与 query(AI 排序的自然语言搜索),便于按需选择。
潜在局限与风险
1. 第三方 API 依赖:服务完全依赖 Camino AI 的可用性与数据质量,存在单点故障风险。
2. API 密钥管理:需用户自行在 ~/.claude/settings.json 配置 CAMINO_API_KEY,密钥泄露可能导致配额滥用。
3. 照片权限与隐私:街景影像可能涉及第三方版权或个人隐私,商业使用需确认授权。
4. 地理覆盖盲区:文档未明确覆盖范围,偏远地区或新兴地点可能返回空结果或低精度坐标。
5. 成本不透明:未提及免费额度与定价,高频调用可能产生意外费用。
适合人群
- 需要批量地理编码地址的数据分析师
- 开发位置感知应用的工程师
- 需验证地点真实性的内容审核者
- 旅行规划、物流路线优化等场景用户
常规风险提醒
- 输入敏感地址(如家庭住址)时,数据将发送至 Camino AI 服务器
- 建议开启
include_photos时评估网络带宽与 API 成本 - 结构化查询建议提供尽可能多的地址组件以提高精度