用途:计算两个地理坐标点之间的空间关系,包括距离、方向、出行时间和人类可读的描述,适合邻近判断、方向提示、出行规划与位置上下文生成。
主要能力:输入起点与终点经纬度,返回距离(米/公里/英里)、方向(方位角、基本方位如 NE、文字描述如 northeast)、出行时间(步行、驾车、骑行分钟数)以及综合描述文本。可通过 include 参数选择只返回 distance、direction、travel_time、description 中的部分结果。
使用方式:先从 https://app.getcamino.ai 获取 API 密钥,在 ~/.claude/settings.json 的环境变量中添加 CAMINO_API_KEY,并重启 Claude Code。调用有两种途径:使用 Shell 脚本 ./scripts/relationship.sh,传入包含 start、end 及可选 include 的 JSON;或使用 curl 向 https://api.getcamino.ai/relationship 发送 POST 请求,携带 X-API-Key 请求头与 JSON 数据。start 与 end 为必填对象,均含 lat、lon 字段。
适用场景:判断两地是否在指定距离内、给出方位参照、估算不同交通方式的耗时、生成可直接阅读的位置关系描述。
限制:必须配置有效 API 密钥方可使用;资料未说明费用、调用配额、坐标精度、支持的区域范围及错误处理方式。