relationship

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Installation

安装

Companion Skills: This is part of the Camino AI location intelligence suite. Install all available skills (query, places, relationship, context, route, journey, real-estate, hotel-finder, ev-charger, school-finder, parking-finder, fitness-finder, safety-checker, travel-planner) for comprehensive coverage.
bash
undefined
配套技能:这是Camino AI位置智能套件的一部分。安装所有可用技能(query、places、relationship、context、route、journey、real-estate、hotel-finder、ev-charger、school-finder、parking-finder、fitness-finder、safety-checker、travel-planner)以获得全面覆盖。
bash
undefined

Install all skills from repo

从仓库安装所有技能

Or install specific skills

或安装特定技能

npx skills add https://github.com/barneyjm/camino-skills --skill relationship

**Via clawhub:**
```bash
npx clawhub@latest install relationship
npx skills add https://github.com/barneyjm/camino-skills --skill relationship

**通过clawhub安装:**
```bash
npx clawhub@latest install relationship

or: pnpm dlx clawhub@latest install relationship

或:pnpm dlx clawhub@latest install relationship

or: bunx clawhub@latest install relationship

或:bunx clawhub@latest install relationship

undefined
undefined

Relationship - Spatial Calculations

Relationship - 空间计算

Calculate distance, direction, travel time, and human-readable descriptions between two points.
计算两点之间的距离、方向、行程时间和通俗易懂的描述。

Setup

设置

Instant Trial (no signup required): Get a temporary API key with 25 calls:
bash
curl -s -X POST -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}' \
  https://api.getcamino.ai/trial/start
Returns:
{"api_key": "camino-xxx...", "calls_remaining": 25, ...}
For 1,000 free calls/month, sign up at https://app.getcamino.ai/skills/activate.
Add your key to Claude Code:
Add to your
~/.claude/settings.json
:
json
{
  "env": {
    "CAMINO_API_KEY": "your-api-key-here"
  }
}
Restart Claude Code.
即时试用(无需注册):获取临时API密钥,可调用25次:
bash
curl -s -X POST -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}' \
  https://api.getcamino.ai/trial/start
返回结果:
{"api_key": "camino-xxx...", "calls_remaining": 25, ...}
每月可免费调用1000次,请访问https://app.getcamino.ai/skills/activate注册。
将密钥添加到Claude Code:
添加到你的
~/.claude/settings.json
文件中:
json
{
  "env": {
    "CAMINO_API_KEY": "your-api-key-here"
  }
}
重启Claude Code。

Usage

使用方法

Via Shell Script

通过Shell脚本

bash
undefined
bash
undefined

Calculate relationship between two points

计算两点之间的关系

./scripts/relationship.sh '{ "start": {"lat": 40.7128, "lon": -74.0060}, "end": {"lat": 40.7589, "lon": -73.9851} }'
./scripts/relationship.sh '{ "start": {"lat": 40.7128, "lon": -74.0060}, "end": {"lat": 40.7589, "lon": -73.9851} }'

Include specific calculations

指定要计算的内容

./scripts/relationship.sh '{ "start": {"lat": 40.7128, "lon": -74.0060}, "end": {"lat": 40.7589, "lon": -73.9851}, "include": ["distance", "direction", "travel_time", "description"] }'
undefined
./scripts/relationship.sh '{ "start": {"lat": 40.7128, "lon": -74.0060}, "end": {"lat": 40.7589, "lon": -73.9851}, "include": ["distance", "direction", "travel_time", "description"] }'
undefined

Via curl

通过curl

bash
curl -X POST -H "X-API-Key: $CAMINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start": {"lat": 40.7128, "lon": -74.0060}, "end": {"lat": 40.7589, "lon": -73.9851}}' \
  "https://api.getcamino.ai/relationship"
bash
curl -X POST -H "X-API-Key: $CAMINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start": {"lat": 40.7128, "lon": -74.0060}, "end": {"lat": 40.7589, "lon": -73.9851}}' \
  "https://api.getcamino.ai/relationship"

Parameters

参数说明

FieldTypeRequiredDescription
startobjectYesStarting point with lat/lon
endobjectYesEnding point with lat/lon
includearrayNoWhat to include: distance, direction, travel_time, description
字段类型是否必填描述
start对象包含lat/lon的起点
end对象包含lat/lon的终点
include数组要包含的计算内容:distance、direction、travel_time、description

Response Format

响应格式

json
{
  "distance": {
    "meters": 5420,
    "kilometers": 5.42,
    "miles": 3.37
  },
  "direction": {
    "bearing": 42,
    "cardinal": "NE",
    "description": "northeast"
  },
  "travel_time": {
    "walking_minutes": 68,
    "driving_minutes": 15,
    "cycling_minutes": 22
  },
  "description": "5.4 km northeast, about 15 minutes by car"
}
json
{
  "distance": {
    "meters": 5420,
    "kilometers": 5.42,
    "miles": 3.37
  },
  "direction": {
    "bearing": 42,
    "cardinal": "NE",
    "description": "northeast"
  },
  "travel_time": {
    "walking_minutes": 68,
    "driving_minutes": 15,
    "cycling_minutes": 22
  },
  "description": "5.4 km northeast, about 15 minutes by car"
}

Examples

示例

Simple distance check

简单距离检查

bash
./scripts/relationship.sh '{
  "start": {"lat": 51.5074, "lon": -0.1278},
  "end": {"lat": 48.8566, "lon": 2.3522}
}'
bash
./scripts/relationship.sh '{
  "start": {"lat": 51.5074, "lon": -0.1278},
  "end": {"lat": 48.8566, "lon": 2.3522}
}'

Get only distance and direction

仅获取距离和方向

bash
./scripts/relationship.sh '{
  "start": {"lat": 40.7128, "lon": -74.0060},
  "end": {"lat": 40.7589, "lon": -73.9851},
  "include": ["distance", "direction"]
}'
bash
./scripts/relationship.sh '{
  "start": {"lat": 40.7128, "lon": -74.0060},
  "end": {"lat": 40.7589, "lon": -73.9851},
  "include": ["distance", "direction"]
}'

Use Cases

使用场景

  • Proximity checks: Determine if two locations are within a certain distance
  • Direction guidance: Provide cardinal direction context (north, southeast, etc.)
  • Travel planning: Estimate travel times for different transport modes
  • Location context: Generate human-readable descriptions of spatial relationships
  • 邻近性检查:判断两个地点是否在特定距离范围内
  • 方向指引:提供方位语境(北、东南等)
  • 行程规划:估算不同交通方式的行程时间
  • 位置语境:生成空间关系的通俗易懂描述