核心用法
Places 技能提供灵活的地点查找能力，支持两种输入模式：自由文本查询（如"埃菲尔铁塔"）和结构化地址组件（街道、城市、州/省、国家等）。用户可通过 POST 请求调用 /search 端点，获取地理坐标、完整地址信息及可选的街景照片。
与 Query 技能的对比：Places 专注于精确的地理编码和特定地点查找，返回标准坐标数据；Query 则面向自然语言场景搜索，具备 AI 排序能力但无照片功能。
典型应用场景：
- 地址解析：将邮政地址转换为经纬度坐标
- 地标识别：快速定位知名景点、建筑
- 位置验证：确认地址的有效性和标准化格式
- 视觉辅助：获取目标地点的街景照片用于环境判断
显著优点
- 双模式输入：既支持直觉化的自然语言查询，也支持高度精确的结构化地址
- 数据完整性：返回包含重要性评分、地址分级、坐标精度的丰富元数据
- 视觉增强：可选的街景照片功能（
include_photos）提供实地环境参考 - 灵活配置：支持搜索深度调节（basic/advanced）、结果数量限制、照片搜索半径自定义
潜在局限
- 无 AI 排序：相比 Query 技能，结果缺乏智能相关性排序，依赖数据源本身的重要性评分
- 环境依赖：需配置
CAMINO_API_KEY环境变量，增加了初次使用门槛 - 单点服务：依赖 Camino AI 单一服务商，无备用数据源机制
- 隐私考量：街景照片可能涉及第三方位置数据的采集与存储
适合人群
- 开发者需要进行批量地址解析或地理编码
- 需要验证用户输入地址格式的业务系统
- 结合地图可视化需求的工作流（如物流、房地产、旅游规划）
- 对特定地点获取精确坐标和视觉参考的研究者
常规风险
- API 密钥泄露：
CAMINO_API_KEY若未妥善保管可能导致未授权调用 - 数据准确性：地理编码结果受底层 OpenStreetMap 等数据源更新频率影响
- 服务可用性：依赖外部 API，存在因网络或服务故障导致查询失败的可能
- 使用成本：高频调用可能产生 API 费用，需关注用量配额