核心用法
route 技能是 Camino AI 位置智能套件的核心组件,专注于两点间的详细路径计算。用户仅需提供起始与终点的经纬度坐标,即可获取包含距离(公里)、预计时长(分钟)及路线摘要的导航数据。支持三种交通模式:驾车(car)、骑行(bike)、步行(foot),并可选开启详细转向步骤(turn-by-turn directions)、路线几何数据(用于地图绘制)及街景影像参考。
调用方式灵活,既可通过 Shell 脚本 ./scripts/route.sh 快速执行,也可直接使用 curl 命令对接 REST API。技能响应为结构化 JSON,包含 distance_km、duration_minutes、summary 及 steps 数组,便于程序化处理。
显著优点
- 多模式覆盖:单一接口支持驾车、骑行、步行,满足多样化出行场景
- 即时试用:无需注册即可获取 25 次临时 API 调用额度,降低体验门槛
- 结构化输出:机器友好的 JSON 格式,易于集成至自动化工作流
- 扩展性强:可选几何数据与街景影像,支持可视化地图应用开发
- 生态完整:作为 Camino AI 套件一员,可与 query、places、journey 等技能协同
潜在缺点与局限性
- 坐标依赖:仅接受经纬度输入,不支持自然语言地址(需配合 geocoding 技能)
- API 额度限制:免费版每月 1,000 次调用,高频场景需付费升级
- 地理覆盖未明:文档未明确说明服务覆盖的国家/地区范围
- 实时交通缺失:未提及动态交通状况(拥堵、事故)对路线的影响
- 离线不可用:纯云端服务,无网络环境无法使用
适合人群
- 需要自动化路径计算的开发者与数据分析师
- 构建地图可视化、物流调度、通勤规划应用的工程团队
- 使用 Claude Code 进行地理位置相关自动化的终端用户
常规风险
- API 密钥泄露风险:
CAMINO_API_KEY需妥善保管,避免硬编码于公共仓库 - 隐私合规:坐标数据可能涉及用户位置隐私,需遵循 GDPR 等法规
- 服务可用性:依赖 Camino AI 云服务稳定性,建议实现降级策略
- 数据精度:路线时长为估算值,实际出行受路况、天气等因素影响