核心用法
places 是 Camino AI 位置智能套件中的地理编码与地点查询技能,专注于通过自由文本查询或结构化地址组件定位全球任意地点。核心功能包括:
- 自由文本搜索:支持自然语言地标查询,如 "Eiffel Tower"
- 结构化地址查询:通过 street、city、state、country、postalcode 等字段精确编码
- 地理编码反查:返回 WGS84 坐标 (lat/lon)、标准化地址、地点类型
- 街景照片获取:可选启用
include_photos获取位置周边街景影像 - 双模式搜索:
basic快速查询 /advanced富数据模式
显著优点
1. 双输入范式灵活:既满足模糊搜索("中央公园附近"),又支持标准化地址录入(物流、政务场景)
2. 视觉化增强:include_photos 与 photo_radius 参数支持获取实景照片,对房产评估、实地调研极具价值
3. 生态整合:与 suite 内 query、route、journey 等 5 个技能形成完整工作流
4. 企业级数据源:依托 Camino AI 商业地理数据库,非开源众包数据
潜在局限
- API 依赖:必需
CAMINO_API_KEY,存在服务可用性与区域网络限制 - 无 AI 排序:相比同套件
query技能,本工具无 AI 相关性重排,复杂语义查询效果有限 - 照片覆盖率:街景影像依赖第三方采集,偏远地区或新开发区域可能缺失
- 计费模式:商业 API 通常按调用量计费,高频场景需成本评估
适合人群
- 需批量地址标准化的数据工程师 / ETL 开发者
- 房产、物流、保险行业需坐标+实景双验证的业务人员
- 构建位置智能应用的开发者,需与
route、journey技能链式调用
常规风险
- 密钥泄露:
CAMINO_API_KEY若硬编码或误提交至版本库,可能导致配额盗刷 - 隐私合规:街景照片可能包含人脸、车牌,需遵守 GDPR、《个人信息保护法》等法规
- 数据精度:OpenStreetMap 等底层数据源在部分国家/地区精度有限
与 Query 技能对比
| 维度 | `/places` | `/query` |
|------|-----------|----------|
| 输入方式 | 结构化/自由文本 | 自然语言+上下文 |
| AI 排序 | ❌ | ✅ |
| 街景照片 | ✅ | ❌ |
| 最佳场景 | 精确地址编码、地标查找 | 语义搜索、推荐类查询 |