核心用法
Camino Query 是一个面向 Claude Code 的位置搜索工具，通过调用 Camino AI 的位置智能 API，实现自然语言驱动的 POI（兴趣点）检索。用户可使用日常用语描述搜索需求（如"时代广场附近安静的咖啡馆"），无需手动输入经纬度——系统会自动为知名地点生成坐标。支持 Shell 脚本或 curl 直接调用，响应包含地点名称、坐标、类型、距离、相关性评分及地址信息。
显著优点
1. 零摩擦自然语言查询：打破传统地理编码的限制，直接用"曼哈顿最好的披萨"这类描述性语句搜索，AI 自动解析意图并定位。
2. 智能坐标推断：对于城市、地标等知名地点，可完全省略 lat/lon 参数，系统内部完成地理编码。
3. AI 排序与摘要：rank=true 启用相关性排序，answer=true 生成人性化结果总结，降低信息过载。
4. 多维度查询能力：支持半径范围（100m-50km）、时间切片（历史数据查询）、OSM ID 精确检索、基础/高级双模式（后者整合网络数据增强）。
5. Claude Code 原生集成：通过 ~/.claude/settings.json 配置 API Key，脚本化调用无缝融入开发工作流。
潜在局限与风险
- 商业 API 依赖：需注册并付费使用 Camino 服务，存在供应商锁定风险；API 密钥需本地存储，存在泄露隐患。
- 覆盖度盲区：依赖 OpenStreetMap（基础模式）或网络爬取（高级模式），偏远地区或新兴店铺可能缺失。
- 坐标推断偏差：AI 生成的坐标对于模糊地名（如同名地点）可能存在误判，未提供置信度指标。
- 时序数据限制：
time参数虽支持历史查询，但未说明数据源更新频率与回溯深度。 - 无本地缓存机制：重复查询会反复消耗 API 额度。
适合人群
- 需要快速验证地点信息的开发者与数据分析师
- 构建位置感知应用的原型开发者
- 已通过 Claude Code 工作流整合多工具链的技术用户
- 对 POI 数据质量要求不极端苛刻的场景（如推荐系统冷启动、内容标注）
常规风险
| 风险类别 | 说明 |
|---------|------|
| 隐私合规 | 搜索历史可能包含敏感位置意图，需确认 Camino 的数据处理协议 |
| 成本失控 | 高级模式与大批量查询可能快速消耗配额，建议设置限额监控 |
| 数据一致性 | OSM 与网络数据源更新不同步，可能导致同名地点信息冲突 |
| 密钥安全 | 本地明文存储 API Key，建议配合密钥管理服务使用 |