核心用法
relationship 是 Camino AI 位置智能套件中的空间关系计算工具，通过调用 https://api.getcamino.ai/relationship 端点，计算任意两点间的地理关系。用户需先获取 API Key 并配置至 Claude Code 环境变量 CAMINO_API_KEY。
基础调用：提供 start 和 end 的经纬度坐标，返回包含多单位距离（米/千米/英里）、方位角与方位描述（如 NE/东北）、步行/驾车/骑行三种交通时间估算，以及自然语言摘要的综合结果。支持通过 include 参数按需筛选输出字段。
典型场景：
- 邻近性检测：判断两点是否在给定距离阈值内
- 方位指引：输出罗盘方位与可读描述
- 出行规划：对比不同交通方式的时间成本
- 位置语境：生成"距您 3.4 公里东南方向，驾车约 8 分钟"类人性化描述
显著优点
1. 多维度输出：单次请求即可获得距离、方向、多模式交通时间、自然语言描述四类数据，无需多次调用
2. 单位国际化：同时提供公制（米、千米）与英制（英里）单位，适配不同用户习惯
3. 交通模式覆盖：内置步行、驾车、骑行三种常见出行方式的时间估算
4. 自然语言生成：自动生成人类可读的描述文本，便于直接展示或对话场景
5. Camino 生态集成：与 query、places、route、journey 等 5 个技能组成完整位置智能方案
潜在缺点与局限性
- API 依赖：完全依赖 Camino 外部服务，离线不可用；存在服务中断、延迟或配额耗尽风险
- 地理覆盖限制：未明确标注支持区域，偏远地区或新建设道路数据可能缺失
- 交通时间估算精度：基于静态模型，未考虑实时路况、天气、交通管制等动态因素，实际时间可能偏差显著
- 仅支持点对点：无法计算多点路径或复杂路线规划（需配合 route/journey 技能）
- 成本不透明：Camino API pricing 未在文档中披露，存在潜在使用成本
适合人群
- 需要快速获取两点空间关系的开发者与数据分析师
- 构建位置感知对话机器人、客服系统的 AI 应用开发者
- 物流、出行、本地生活类应用的 POI 关系计算场景
- 已采用或计划采用 Camino AI 全家桶的技术团队
常规风险
| 风险类别 | 说明 |
|---------|------|
| API 密钥泄露 | `CAMINO_API_KEY` 存储于本地配置文件，存在误提交至版本控制或共享环境的风险 |
| 数据隐私 | 地理位置信息上传至第三方 Camino 服务，需评估是否符合 GDPR/CCPA 等合规要求 |
| 服务可用性 | 外部 API 单点故障可能导致功能完全不可用，需设计降级策略 |
| 响应延迟 | 网络波动或 API 限流可能影响实时性要求高的场景 |
| 成本失控 | 高频调用可能产生意外费用，建议设置用量监控与告警 |