核心用法
camino-places 是 Camino AI 位置智能套件中的地点查询技能，专注于地理编码（Geocoding）和地标检索。它支持两种输入模式：
1. 自由文本查询：如 "Eiffel Tower"、"Central Park"，适合知名地标和POI
2. 结构化地址组件：street、city、state、country、postalcode 等字段，适合精确地址解析
典型调用方式通过 shell 脚本或 curl 直接访问 /search API 端点，返回坐标（lat/lon）、完整地址、地点类型及可选的街景照片。
关键参数
| 参数 | 说明 |
|------|------|
| `query` | 自由文本搜索词 |
| `street`/`city`/`state`/`country`/`postalcode` | 结构化地址字段 |
| `include_photos` | 是否返回街景照片 |
| `photo_radius` | 照片搜索半径（10-500米） |
| `mode` | "basic" 或 "advanced"，后者返回更丰富的网络增强数据 |
| `limit` | 结果数量上限（1-50，默认10） |
---
显著优点
- 双重输入模式：兼顾自然语言便利性和结构化数据精确性
- 街景照片支持：
include_photos=true可获取带地理位置和朝向信息的实景图片，增强空间感知 - 丰富的地址解析：返回
importance评分、详细地址层级、地点类型等元数据 - 灵活的地理编码：支持从邮政编码、城市级别到具体门牌号的多粒度查询
- 与套件协同：作为 Camino 技能套件的一部分，可与
camino-query（AI排序）、camino-route（路线规划）等无缝配合
---
潜在缺点与局限性
- 无AI排序：与
camino-query不同，camino-places不基于语义理解进行结果排序，仅返回匹配度最高的地点 - 依赖外部API：需要
CAMINO_API_KEY，每月100次免费额度，超出需付费（$0.001/请求）或升级 - 街景照片覆盖有限：
include_photos的可用性取决于 Camino 的街景数据库覆盖范围，偏远地区可能无图 - 无自然语言上下文：不适合 "安静的咖啡馆"、"适合带狗的公园" 等需要语义理解的查询
- 模式切换成本："basic" 和 "advanced" 模式的数据 richness 差异大，需根据场景手动选择
---
适合人群
- 开发者/数据工程师：需要批量地理编码地址、构建位置数据库
- 地图应用开发者：需要精确坐标和结构化地址解析
- 房地产/物流行业：需要验证地址、计算位置关联度
- 旅行规划助手：需要地标坐标和街景预览
- Claude Code 用户：在对话中快速获取 "某地的坐标是什么"、"这个地址在哪"
---
常规风险
| 风险类型 | 说明 |
|----------|------|
| **API 密钥泄露** | `CAMINO_API_KEY` 需存储在 `~/.claude/settings.json`，存在本地文件泄露风险；建议限制 key 的权限范围 |
| **数据隐私** | 查询的地址信息会发送至 Camino 服务器，敏感位置（如家庭地址）需谨慎 |
| **成本失控** | 超出免费额度后按 $0.001/请求计费，高频调用需监控用量；支持 x402 无密钥付费路径，但当前技能未启用 |
| **数据准确性** | 依赖 Nominatim/OpenStreetMap 等底层数据源，新建筑、临时变更可能未同步 |
| **服务可用性** | 单点依赖 Camino API，需考虑降级方案或缓存策略 |
---
与 camino-query 的对比建议
| 场景 | 推荐技能 |
|------|---------|
| "Eiffel Tower 在哪" | `camino-places` |
| "1600 Pennsylvania Avenue, DC" | `camino-places`（结构化） |
| "时代广场附近安静的咖啡馆" | `camino-query`（AI语义排序） |
| "我需要这个地址的坐标做计算" | `camino-places` |