Back to Details

journey

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
配套Skill：这是Camino AI位置智能套件的一部分。安装所有可用的Skill（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

Install all skills from repo

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

Or install specific skills

Or install specific skills

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

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

**通过clawhub安装：**
```bash
npx clawhub@latest install journey

or: pnpm dlx clawhub@latest install journey

or: pnpm dlx clawhub@latest install journey

or: bunx clawhub@latest install journey

or: bunx clawhub@latest install journey

undefined
undefined

Journey - Multi-Stop Planning

Journey - 多站点行程规划

Plan multi-waypoint journeys with route optimization, feasibility analysis, and time budget constraints.
规划包含路线优化、可行性分析和时间预算约束的多站点行程。

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.
即时试用（无需注册）：获取一个包含25次调用额度的临时API密钥：
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

Plan a simple journey

Plan a simple journey

./scripts/journey.sh '{ "waypoints": [ {"lat": 40.7128, "lon": -74.0060, "purpose": "Start at hotel"}, {"lat": 40.7484, "lon": -73.9857, "purpose": "Visit Empire State Building"}, {"lat": 40.7614, "lon": -73.9776, "purpose": "Lunch in Midtown"} ] }'
./scripts/journey.sh '{ "waypoints": [ {"lat": 40.7128, "lon": -74.0060, "purpose": "Start at hotel"}, {"lat": 40.7484, "lon": -73.9857, "purpose": "Visit Empire State Building"}, {"lat": 40.7614, "lon": -73.9776, "purpose": "Lunch in Midtown"} ] }'

With transport mode and time budget

With transport mode and time budget

./scripts/journey.sh '{ "waypoints": [ {"lat": 40.7128, "lon": -74.0060, "purpose": "Start"}, {"lat": 40.7484, "lon": -73.9857, "purpose": "Empire State"}, {"lat": 40.7614, "lon": -73.9776, "purpose": "MoMA"} ], "constraints": { "transport": "foot", "time_budget": "3 hours" } }'
undefined
./scripts/journey.sh '{ "waypoints": [ {"lat": 40.7128, "lon": -74.0060, "purpose": "Start"}, {"lat": 40.7484, "lon": -73.9857, "purpose": "Empire State"}, {"lat": 40.7614, "lon": -73.9776, "purpose": "MoMA"} ], "constraints": { "transport": "foot", "time_budget": "3 hours" } }'
undefined

Via curl

通过curl

bash
curl -X POST -H "X-API-Key: $CAMINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "waypoints": [
      {"lat": 40.7128, "lon": -74.0060, "purpose": "Start"},
      {"lat": 40.7484, "lon": -73.9857, "purpose": "Empire State"}
    ],
    "constraints": {"transport": "foot"}
  }' \
  "https://api.getcamino.ai/journey"
bash
curl -X POST -H "X-API-Key: $CAMINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "waypoints": [
      {"lat": 40.7128, "lon": -74.0060, "purpose": "Start"},
      {"lat": 40.7484, "lon": -73.9857, "purpose": "Empire State"}
    ],
    "constraints": {"transport": "foot"}
  }' \
  "https://api.getcamino.ai/journey"

Parameters

参数

FieldTypeRequiredDefaultDescription
waypointsarrayYes-List of waypoints with lat, lon, and purpose (min 2)
constraints.transportstringNo"walking"Transport mode: "walking", "car", or "bike"
constraints.time_budgetstringNo-Time constraint (e.g., "2 hours", "90 minutes")
constraints.preferencesarrayNo[]Route preferences
字段类型是否必填默认值描述
waypoints数组是-包含纬度（lat）、经度（lon）和出行目的（purpose）的站点列表（最少2个）
constraints.transport字符串否"walking"交通方式："walking"（步行）、"car"（驾车）或"bike"（骑行）
constraints.time_budget字符串否-时间约束（例如："2 hours"、"90 minutes"）
constraints.preferences数组否[]路线偏好

Waypoint Object

站点对象

FieldTypeRequiredDescription
latfloatYesLatitude of the waypoint
lonfloatYesLongitude of the waypoint
purposestringNoDescription of why you're visiting this waypoint
字段类型是否必填描述
lat浮点数是站点的纬度
lon浮点数是站点的经度
purpose字符串否访问该站点的原因描述

Response Format

响应格式

json
{
  "feasible": true,
  "total_distance_km": 4.2,
  "total_time_minutes": 52,
  "total_time_formatted": "52 minutes",
  "transport_mode": "foot",
  "route_segments": [
    {
      "from": "Start",
      "to": "Empire State",
      "distance_km": 4.2,
      "duration_minutes": 52
    }
  ],
  "analysis": {
    "summary": "This walking journey is feasible...",
    "optimization_opportunities": []
  }
}
json
{
  "feasible": true,
  "total_distance_km": 4.2,
  "total_time_minutes": 52,
  "total_time_formatted": "52 minutes",
  "transport_mode": "foot",
  "route_segments": [
    {
      "from": "Start",
      "to": "Empire State",
      "distance_km": 4.2,
      "duration_minutes": 52
    }
  ],
  "analysis": {
    "summary": "This walking journey is feasible...",
    "optimization_opportunities": []
  }
}

Examples

示例

Day trip planning

一日游规划

bash
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 48.8584, "lon": 2.2945, "purpose": "Eiffel Tower"},
    {"lat": 48.8606, "lon": 2.3376, "purpose": "Louvre Museum"},
    {"lat": 48.8530, "lon": 2.3499, "purpose": "Notre-Dame"},
    {"lat": 48.8867, "lon": 2.3431, "purpose": "Sacré-Cœur"}
  ],
  "constraints": {
    "transport": "foot",
    "time_budget": "6 hours"
  }
}'
bash
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 48.8584, "lon": 2.2945, "purpose": "Eiffel Tower"},
    {"lat": 48.8606, "lon": 2.3376, "purpose": "Louvre Museum"},
    {"lat": 48.8530, "lon": 2.3499, "purpose": "Notre-Dame"},
    {"lat": 48.8867, "lon": 2.3431, "purpose": "Sacré-Cœur"}
  ],
  "constraints": {
    "transport": "foot",
    "time_budget": "6 hours"
  }
}'

Business meeting route

商务会议路线

bash
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Office"},
    {"lat": 40.7580, "lon": -73.9855, "purpose": "Client meeting"},
    {"lat": 40.7614, "lon": -73.9776, "purpose": "Lunch"},
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Return to office"}
  ],
  "constraints": {
    "transport": "car",
    "time_budget": "2 hours"
  }
}'
bash
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Office"},
    {"lat": 40.7580, "lon": -73.9855, "purpose": "Client meeting"},
    {"lat": 40.7614, "lon": -73.9776, "purpose": "Lunch"},
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Return to office"}
  ],
  "constraints": {
    "transport": "car",
    "time_budget": "2 hours"
  }
}'

Cycling tour

骑行游览

bash
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 37.7749, "lon": -122.4194, "purpose": "Start downtown SF"},
    {"lat": 37.8199, "lon": -122.4783, "purpose": "Golden Gate Bridge"},
    {"lat": 37.8270, "lon": -122.4230, "purpose": "Sausalito"}
  ],
  "constraints": {
    "transport": "bike"
  }
}'
bash
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 37.7749, "lon": -122.4194, "purpose": "Start downtown SF"},
    {"lat": 37.8199, "lon": -122.4783, "purpose": "Golden Gate Bridge"},
    {"lat": 37.8270, "lon": -122.4230, "purpose": "Sausalito"}
  ],
  "constraints": {
    "transport": "bike"
  }
}'

Use Cases

使用场景

  • Trip itinerary validation: Check if a planned itinerary is feasible within time constraints
  • Route optimization: Get suggestions for optimizing multi-stop journeys
  • Travel time estimation: Understand total journey time across multiple destinations
  • Tour planning: Plan walking tours, cycling routes, or driving trips
  • 行程验证：检查规划的行程是否在时间约束内可行
  • 路线优化：获取多站点行程的优化建议
  • 行程时间估算：了解跨多个目的地的总行程时间
  • 游览规划：规划步行游览、骑行路线或驾车行程