Back to Details

places

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

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 places

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

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

or: pnpm dlx clawhub@latest install places

or: pnpm dlx clawhub@latest install places

or: bunx clawhub@latest install places

or: bunx clawhub@latest install places

undefined
undefined

Places - Flexible Place Lookup

Places - 灵活地点查询

Locate places using free-form queries or structured address components. Supports geocoding, place lookup, and optional street-level imagery.
支持使用自由格式查询或结构化地址组件定位地点。支持地理编码、地点查找及可选的街景级影像。

Places vs Query

Places 与 Query 对比

Feature
/places
/query
MethodPOSTGET
InputFree-form OR structured addressNatural language with context
CoordinatesReturns them (geocoding)Can auto-generate for search center
AI RankingNoYes
PhotosOptional street-level imageryNo
Best For"Eiffel Tower", address lookup"quiet cafes near Times Square"
Use 
/places
 for geocoding addresses or finding specific named places. Use 
/query
 for natural language queries with AI ranking.
特性
/places
/query
请求方法POSTGET
输入自由格式或结构化地址带上下文的自然语言
坐标返回坐标（地理编码）可自动生成搜索中心点坐标
AI排序无有
照片可选街景级影像无
最佳适用场景"埃菲尔铁塔"、地址查找"时代广场附近的安静咖啡馆"
使用
/places
 进行地址地理编码或查找特定命名地点。 使用
/query
 进行带AI排序的自然语言查询。

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

Free-form search for a landmark

自由格式搜索地标

./scripts/places.sh '{"query": "Eiffel Tower"}'
./scripts/places.sh '{"query": "Eiffel Tower"}'

Search with street-level photos

搜索并包含街景照片

./scripts/places.sh '{"query": "Empire State Building", "include_photos": true}'
./scripts/places.sh '{"query": "Empire State Building", "include_photos": true}'

Structured address search

结构化地址搜索

./scripts/places.sh '{"street": "1600 Pennsylvania Avenue", "city": "Washington", "state": "DC", "country": "USA"}'
./scripts/places.sh '{"street": "1600 Pennsylvania Avenue", "city": "Washington", "state": "DC", "country": "USA"}'

Search by city

按城市搜索

./scripts/places.sh '{"city": "San Francisco", "state": "California", "limit": 5}'
undefined
./scripts/places.sh '{"city": "San Francisco", "state": "California", "limit": 5}'
undefined

Via curl (direct API calls)

通过curl（直接调用API）

The skill is named 
places
but calls the 
/search
API endpoint. For direct API calls:
bash
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"
该技能名为
places
，但调用的是
/search
API端点。直接调用API的方式：
bash
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"

Parameters

参数说明

ParameterTypeRequiredDefaultDescription
querystringNo*-Free-form search (e.g., "Eiffel Tower", "Central Park")
amenitystringNo-Amenity/POI type
streetstringNo-Street name and number
citystringNo-City name
countystringNo-County name
statestringNo-State or province
countrystringNo-Country name or code
postalcodestringNo-Postal/ZIP code
limitintNo10Maximum results (1-50)
include_photosboolNofalseInclude street-level imagery
photo_radiusintNo100Photo search radius in meters (10-500)
modestringNo"basic""basic" or "advanced" search depth
*Either 
query
or at least one address component is required.
参数类型是否必填默认值描述
query字符串否*-自由格式搜索（例如："埃菲尔铁塔"、"中央公园"）
amenity字符串否-便利设施/兴趣点类型
street字符串否-街道名称及门牌号
city字符串否-城市名称
county字符串否-县/郡名称
state字符串否-州/省名称
country字符串否-国家名称或代码
postalcode字符串否-邮政编码/ZIP码
limit整数否10最大结果数（1-50）
include_photos布尔值否false是否包含街景级影像
photo_radius整数否100照片搜索半径（单位：米，10-500）
mode字符串否"basic"搜索深度："basic"或"advanced"
*必须提供
query
或至少一个地址组件。

Response Format

响应格式

json
[
  {
    "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
  }
]
json
[
  {
    "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
  }
]

Examples

示例

Geocode an address

地址地理编码

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

Find a landmark with photos

查找带照片的地标

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

Search by postal code

按邮政编码搜索

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

Advanced mode for richer data

高级模式获取更丰富数据

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

Best Practices

最佳实践

  • Use 
    query
    for landmarks, POIs, and well-known places
  • Use structured address fields for precise geocoding
  • Enable 
    include_photos
    when you need visual context
  • Use 
    mode: "advanced"
    for web-enriched place data
  • Combine address components for more accurate results
  • 查找地标、兴趣点及知名地点时使用
    query
    参数
  • 精准地理编码时使用结构化地址字段
  • 需要视觉上下文时启用
    include_photos
  • 需要网络增强的地点数据时使用
    mode: "advanced"
  • 组合多个地址组件以获得更准确的结果