核心用法
camino-query 是 Camino AI 位置智能套件的核心搜索模块，允许用户通过自然语言查询全球真实世界地点。该技能将语义理解（如“安静的咖啡馆”“曼哈顿最好的披萨”）转化为精确的地理坐标与POI检索，无需手动输入经纬度即可智能定位已知地标。
典型工作流包括：用户提交自然语言描述 → AI解析并生成坐标 → 调用Overture Maps或OSM数据源 → 返回带距离、类型、相关度评分的结构化结果。支持半径搜索、时间范围过滤（历史数据）、OSM ID直接查询等高级模式，并可生成AI摘要回答。
显著优点
语义化搜索体验：打破传统关键词搜索限制，理解“安静”“适合工作”“平价”等属性描述，AI自动排序结果相关度（rank: true）。
坐标智能推断：对于“时代广场附近”“布鲁克林”等已知地点，系统自动解析地理坐标，降低使用门槛。
多源数据融合：基础模式使用Overture Maps（BigQuery），高级模式（mode: advanced）融合网页数据丰富POI信息；OSM查询模式支持历史时间切片分析。
灵活的输出格式：可返回原始JSON数据或AI生成的自然语言摘要（answer: true），适配自动化脚本与人机交互场景。
成本友好：每月100次免费调用，支持x402支付协议（USDC on Base，$0.001/请求）的备选付费路径。
潜在缺点与局限性
API密钥依赖：核心功能强制要求CAMINO_API_KEY环境变量，尽管有x402替代方案，但当前技能实现未原生集成该支付路径。
地理覆盖偏差：Overture Maps在北美、西欧数据质量较高，新兴市场或偏远地区POI完整度可能不足。
实时性限制：依赖OSM/Overture等第三方数据源，新开店铺、临时关闭等信息更新存在延迟（通常数天至数周）。
中文支持未明确：文档示例均为英文查询，非英语自然语言的解析质量未经充分验证。
速率与配额：免费层100次/月对高频场景（如批量地址校验、实时导航）明显不足，付费升级路径透明度有限。
适合人群
- 开发者构建LBS应用（本地生活、旅游规划、房产分析）
- 数据分析师需要批量地理编码与POI检索
- Claude Code用户进行自然语言驱动的位置探索
- 需要历史地理数据（
time参数）的研究场景
常规风险
数据隐私：查询内容（地点兴趣、当前位置）传输至Camino AI服务器，敏感位置搜索存在隐私暴露风险。
API密钥安全：密钥以环境变量形式配置，共享环境或代码提交时存在泄漏风险，建议配合Claude Code的env配置隔离。
结果准确性：AI生成的坐标与相关度评分可能存在偏差，关键业务场景需人工校验或设置合理置信度阈值。
服务连续性：依赖Camino AI API可用性，生产环境需考虑降级策略（如缓存、备选数据源）。
合规注意：POI数据使用需遵守Overture Maps与OSM的开放数据许可条款，商业应用需确认授权范围。