核心功能
Relationship 是 Camino 平台提供的地理位置空间关系计算 Skill,专注于解析两点间的多维空间数据。核心能力覆盖四大维度:
| 维度 | 输出内容 |
|------|---------|
| 距离 | 米/公里/英里三单位同步返回 |
| 方向 | 精确方位角 + 八方位 cardinal 描述 |
| 通行时间 | 步行/驾车/骑行三种模式预估 |
| 自然描述 | 一体化人类可读文本(如"5.4 km 东北方向,驾车约15分钟") |
显著优点
- 多模态输出:单一 API 调用即可获取距离、方向、时间、描述四类数据,无需多次请求
- 精准方向系统:同时提供数值 bearing(0-360°)与语义化 cardinal(NE/SW 等),兼顾机器解析与人工阅读
- 实用出行场景:内置步行、驾车、骑行三种通行时间估算,直接支撑导航、物流、行程规划等场景
- 零配置即用:通过封装脚本
./scripts/relationship.sh简化调用,支持 JSON 参数透传
局限性与风险
必须关注的数据源与合规问题:
1. 第三方 API 依赖:所有计算依赖 api.getcamino.ai,服务可用性、数据准确性、定价策略均由 Camino 控制,存在供应商锁定风险
2. 地理数据盲区:未明确说明是否支持全球覆盖或特定区域(如偏远地区、室内坐标)可能存在数据缺失
3. 时间估算精度:travel_time 基于通用交通模型,未考虑实时路况、交通管制、地形坡度,实际误差可能显著
4. API 密钥管理:需配置 CAMINO_API_KEY 环境变量,共享环境或版本控制泄露风险需额外防护
适用人群
- 开发地理围栏、就近服务匹配的位置服务开发者
- 需要批量计算门店、仓库、配送点空间关系的物流/零售运营团队
- 构建行程规划、POI 推荐类应用的 AI 助手开发者
常规风险提示
- 网络依赖:离线场景完全不可用
- 速率限制:未披露配额,高并发场景需提前测试
- 坐标精度:输入坐标精度直接影响输出质量,需注意浮点精度与 Datum 一致性