核心用法
Places 是 Camino AI 定位智能套件的核心组件，专注于两类场景：地理编码（将地址转换为坐标）与地标查询（通过名称定位具体地点）。区别于同套件的 /query 接口，/places 采用 POST 方法，支持自由文本（如"Eiffel Tower"）或结构化地址字段（street/city/state/country 等）双模式输入，返回标准化地理信息包含经纬度、地址层级、地点类型及重要性评分。
显著特点包括：
- 灵活查询：既接受口语化地标名称，也支持分字段精确地址
- 街景影像：可选
include_photos参数获取带方位角的街景照片 URL - 双模式深度：
mode: "basic"快速响应，"advanced"返回网络增强的丰富数据
显著优点
1. 零门槛试用：25 次免费调用无需注册，正式用户享 1,000 次/月额度
2. 结构化响应：返回数据包含完整地址层级、坐标精度及地点重要性评分，便于下游过滤
3. 视觉上下文：街景照片功能在房地产评估、实地勘察场景中价值突出
4. 与 Query 互补：与套件内 AI 排序的 /query 形成能力矩阵——Places 负责"找得到"，Query 负责"找得好"
潜在局限
- 无 AI 排序：结果按数据源重要性评分，不支持自然语言语义理解或个性化排序
- 照片覆盖依赖第三方：街景影像可用性受 Mapillary 等数据源覆盖范围限制
- 地理局限：主要依赖 OpenStreetMap 数据，部分新兴市场或偏远地区可能精度不足
适合人群
- 开发者需快速集成标准化地理编码能力
- 房地产、物流、旅游行业需批量地址转坐标
- 需结合视觉信息验证地点真实性的场景（如远程选址）
常规风险
- API 密钥管理：需配置
CAMINO_API_KEY，泄露可能导致配额耗尽 - 配额消耗意识：
advanced模式与include_photos可能消耗更高额度，需在调用层做好缓存 - 数据合规：街景照片可能涉及隐私敏感区域，商用需确认当地测绘法规