{"skill":{"slug":"camino-route","displayName":"Route","summary":"Get detailed routing between two points with distance, duration, and optional turn-by-turn directions. Use when you need navigation instructions or travel ti...","description":"---\nname: camino-route\ndescription: \"Get detailed routing between two points with distance, duration, and optional turn-by-turn directions. Use when you need navigation instructions or travel time estimates between locations.\"\nmetadata: {\"clawdbot\":{\"emoji\":\"🧭\",\"requires\":{\"env\":[\"CAMINO_API_KEY\"],\"binaries\":[\"curl\",\"jq\"]},\"primaryEnv\":\"CAMINO_API_KEY\"}}\n---\n\n## Installation\n\n**Companion Skills**: This is part of the Camino AI location intelligence suite. Install all available skills (camino-query, camino-places, camino-relationship, camino-context, camino-route, camino-journey, camino-real-estate, camino-hotel-finder, camino-ev-charger, camino-school-finder, camino-parking-finder, camino-fitness-finder, camino-safety-checker, camino-travel-planner) for comprehensive coverage.\n\n```bash\n# Install all skills from repo\nnpx skills add https://github.com/barneyjm/camino-skills\n\n# Or install specific skills\nnpx skills add https://github.com/barneyjm/camino-skills --skill camino-route\n```\n\n**Via clawhub:**\n```bash\nnpx clawhub@latest install camino-route\n# or: pnpm dlx clawhub@latest install camino-route\n# or: bunx clawhub@latest install camino-route\n```\n\n# Route - Point-to-Point Navigation\n\nGet detailed routing between two points with distance, duration, and optional turn-by-turn directions.\n\n## Setup\n\nThese skills shell out to `curl` and authenticate via the `CAMINO_API_KEY` environment variable. Sign up at [https://app.getcamino.ai/skills/activate](https://app.getcamino.ai/skills/activate) for 100 free calls/month and an API key.\n\n**Add your key to Claude Code:**\n\nAdd to your `~/.claude/settings.json`:\n\n```json\n{\n  \"env\": {\n    \"CAMINO_API_KEY\": \"your-api-key-here\"\n  }\n}\n```\n\nRestart Claude Code.\n\n**Alternative — pay-per-request via [x402](https://x402.org):** Camino's paid endpoints also accept HTTP 402 payments in USDC on Base ($0.001/request) from any x402-capable client, with no signup or API key. These skills don't use this path; it's for agents and clients that speak x402 natively.\n\n## Usage\n\n### Via Shell Script\n\n```bash\n# Get driving directions\n./scripts/route.sh '{\n  \"start_lat\": 40.7128,\n  \"start_lon\": -74.0060,\n  \"end_lat\": 40.7589,\n  \"end_lon\": -73.9851\n}'\n\n# Walking directions\n./scripts/route.sh '{\n  \"start_lat\": 40.7128,\n  \"start_lon\": -74.0060,\n  \"end_lat\": 40.7589,\n  \"end_lon\": -73.9851,\n  \"mode\": \"foot\"\n}'\n\n# With route geometry for mapping\n./scripts/route.sh '{\n  \"start_lat\": 40.7128,\n  \"start_lon\": -74.0060,\n  \"end_lat\": 40.7589,\n  \"end_lon\": -73.9851,\n  \"mode\": \"bike\",\n  \"include_geometry\": true\n}'\n```\n\n### Via curl\n\n```bash\ncurl -H \"X-API-Key: $CAMINO_API_KEY\" \\\n  \"https://api.getcamino.ai/route?start_lat=40.7128&start_lon=-74.0060&end_lat=40.7589&end_lon=-73.9851&mode=car\"\n```\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| start_lat | float | Yes | - | Starting latitude |\n| start_lon | float | Yes | - | Starting longitude |\n| end_lat | float | Yes | - | Ending latitude |\n| end_lon | float | Yes | - | Ending longitude |\n| mode | string | No | \"car\" | Transport mode: \"car\", \"bike\", or \"foot\" |\n| include_geometry | bool | No | false | Include detailed route geometry for mapping |\n| include_imagery | bool | No | false | Include street-level imagery at waypoints |\n\n## Response Format\n\n```json\n{\n  \"distance_km\": 6.8,\n  \"duration_minutes\": 18,\n  \"mode\": \"car\",\n  \"summary\": \"Head north on Broadway, then east on 42nd Street\",\n  \"steps\": [\n    {\n      \"instruction\": \"Head north on Broadway\",\n      \"distance_m\": 2400,\n      \"duration_s\": 420\n    },\n    {\n      \"instruction\": \"Turn right onto 42nd Street\",\n      \"distance_m\": 1800,\n      \"duration_s\": 300\n    }\n  ]\n}\n```\n\n## Examples\n\n### Walking directions\n```bash\n./scripts/route.sh '{\n  \"start_lat\": 51.5074,\n  \"start_lon\": -0.1278,\n  \"end_lat\": 51.5014,\n  \"end_lon\": -0.1419,\n  \"mode\": \"foot\"\n}'\n```\n\n### Cycling with geometry\n```bash\n./scripts/route.sh '{\n  \"start_lat\": 37.7749,\n  \"start_lon\": -122.4194,\n  \"end_lat\": 37.8199,\n  \"end_lon\": -122.4783,\n  \"mode\": \"bike\",\n  \"include_geometry\": true\n}'\n```\n\n### Driving directions with imagery\n```bash\n./scripts/route.sh '{\n  \"start_lat\": 40.7128,\n  \"start_lon\": -74.0060,\n  \"end_lat\": 40.7589,\n  \"end_lon\": -73.9851,\n  \"mode\": \"car\",\n  \"include_imagery\": true\n}'\n```\n\n## Use Cases\n\n- **Navigation**: Get turn-by-turn directions for any transport mode\n- **Travel time estimation**: Know how long it takes to get between two points\n- **Map visualization**: Include geometry data for drawing routes on maps\n- **Commute planning**: Compare driving, cycling, and walking times\n","topics":["Travel"],"tags":{"latest":"2.0.1"},"stats":{"comments":0,"downloads":1286,"installsAllTime":48,"installsCurrent":0,"stars":2,"versions":3},"createdAt":1771281016898,"updatedAt":1778699514517},"latestVersion":{"version":"2.0.1","createdAt":1778699270814,"changelog":"Sync from camino-skills@2.0.1","license":"MIT-0"},"metadata":{"setup":[{"key":"CAMINO_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"james-southendsolutions","userId":"s17dekpybzcxf10vsx8arm960n86hhnf","displayName":"James-southendsolutions","image":"https://avatars.githubusercontent.com/u/93152760?v=4"},"moderation":null}