安装

配套技能（Companion Skills）：本技能属于 Camino AI 地理智能套件（Camino AI location intelligence suite）。为获得全面覆盖能力，建议安装所有可用技能（包括 query、places、relationship、context、route、journey、real-estate、hotel-finder、ev-charger、school-finder、parking-finder、fitness-finder、safety-checker、travel-planner）。

# 从代码仓库安装全部技能
npx skills add https://github.com/barneyjm/camino-skills

# 或仅安装指定技能
npx skills add https://github.com/barneyjm/camino-skills --skill places

通过 clawhub 安装：

npx clawhub@latest install places
# 或：pnpm dlx clawhub@latest install places
# 或：bunx clawhub@latest install places

Places — 灵活的地点查询

支持使用自由文本查询或结构化地址组件定位地点。功能涵盖地理编码（geocoding）、地点检索，以及可选的街景影像（street-level imagery）。

Places 与 Query 对比

请使用 /places 进行地址地理编码或查找特定命名地点。
请使用 /query 执行自然语言查询，并启用 AI 排序能力。

配置

即时试用（无需注册）： 获取一个临时 API 密钥，含 25 次调用配额：

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, ...}

如需每月 1,000 次免费调用，请访问 https://app.getcamino.ai/skills/activate 注册开通。

将密钥添加至 Claude Code：

在 ~/.claude/settings.json 中添加以下配置：

{
  "env": {
    "CAMINO_API_KEY": "your-api-key-here"
  }
}

随后重启 Claude Code。

使用方式

通过 Shell 脚本调用

# 自由文本搜索地标
./scripts/places.sh '{"query": "Eiffel Tower"}'

# 启用街景照片的搜索
./scripts/places.sh '{"query": "Empire State Building", "include_photos": true}'

# 结构化地址搜索
./scripts/places.sh '{"street": "1600 Pennsylvania Avenue", "city": "Washington", "state": "DC", "country": "USA"}'

# 按城市搜索（限制返回 5 条结果）
./scripts/places.sh '{"city": "San Francisco", "state": "California", "limit": 5}'

通过 curl（直连 API）

该技能名称为 places，但实际调用的是 /search API 端点。若需直接调用 API：

curl -X POST -H "X-API-Key: $CAMINO_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"query": "Eiffel Tower", "include_photos": true}' 
  "https://api.getcamino.ai/search"

参数说明

*query 与至少一个地址字段（如 street、city 等）二者需满足其一。

响应格式

[
  {
    "display_name": "Eiffel Tower, 5 Avenue Anatole France, 75007 Paris, France",
    "lat": 48.8584,
    "lon": 2.2945,
    "type": "tourism",
    "importance": 0.95,
    "address": {
      "tourism": "Eiffel Tower",
      "road": "Avenue Anatole France",
      "city": "Paris",
      "country": "France",
      "postcode": "75007"
    },
    "photos": [
      {
        "url": "https://...",
        "lat": 48.8580,
        "lon": 2.2948,
        "heading": 45
      }
    ],
    "has_street_imagery": true
  }
]

使用示例

地址地理编码

./scripts/places.sh '{"street": "350 Fifth Avenue", "city": "New York", "state": "NY"}'

带街景照片的地标查询

./scripts/places.sh '{"query": "Statue of Liberty", "include_photos": true, "photo_radius": 200}'

按邮政编码搜索

./scripts/places.sh '{"postalcode": "90210", "country": "USA"}'

启用高级模式获取更丰富的数据

./scripts/places.sh '{"query": "Times Square", "mode": "advanced", "include_photos": true}'

最佳实践

• 对地标、兴趣点（POI）及广为人知的地点，优先使用 query 参数
• 对高精度地理编码任务，请使用结构化地址字段（如 street、city 等）
• 当需要视觉上下文时，启用 include_photos
• 如需获取网页增强型地点信息，请设置 mode: "advanced"
• 组合多个地址字段（如 street + city + state）可显著提升匹配准确率