核心用法
baidu-nearby 是百度官方能力集合，提供三类核心服务：
1. 网页搜索 (`baidu_search`) — 替代传统搜索引擎的脚本化查询
2. 路线规划 (`baidu_direction`) — 支持驾车/骑行/步行/公交四种出行模式
3. 附近推荐 (`baidu_nearby`) — 基于LBS的餐饮、景点、酒店、商场等场所发现
通过简单的命令行调用即可获取结构化数据，无需处理复杂的百度API原生接口。依赖纯Python标准库，零第三方包依赖，部署极简。
显著优点
- 官方数据权威性：直接对接百度LBS开放平台，地图数据覆盖中国境内高精度POI
- 本土化适配：地址解析、分类标签（餐饮/景点/酒店等）完全针对中文场景设计
- 极简部署：无
requests/httpx等依赖，仅使用urllib实现，兼容性强 - 多模态出行：路线规划覆盖驾驶、骑行、步行、公共交通全场景
- 灵活定位：支持地名、详细地址、坐标（lat,lng）三种输入方式
潜在局限
- 地域限制：百度地图数据境外覆盖弱，海外场景基本不可用
- API配额依赖：需申请百度AK密钥，免费额度有限，高并发需付费
- 反爬风险：网页搜索模块可能受百度反爬策略影响，稳定性低于官方Search API
- 无实时路况：路线规划未明确支持动态交通状况（如拥堵规避）
- 功能粒度粗：附近推荐仅支持预设6大类，无法细分子类别（如仅火锅、仅快捷酒店）
适合人群
- 需要中国境内位置服务的自动化脚本开发者
- 构建本地生活类Agent（订餐、导航、旅游规划）的AI应用开发者
- 追求零依赖、轻量级部署的边缘计算/IoT场景
- 快速原型验证阶段，暂无需接入高德/腾讯地图的差异化需求
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 密钥泄露 | `BAIDU_API_KEY`为敏感环境变量 | 使用密钥管理服务，禁止硬编码 |
| 输入注入 | 地址参数未展示SQL/XSS级过滤 | 对`origin`/`destination`做长度与字符白名单校验 |
| API限流 | 免费AK有QPS限制（通常10-100次/秒） | 实现指数退避重试，监控429响应 |
| 数据隐私 | 用户位置信息传输至百度服务器 | 明确隐私协议，敏感坐标做模糊化处理 |
| SSL验证 | 依赖系统证书链，旧系统可能校验失败 | 容器化部署时确保证书包更新 |
> 总体评估：T2可信度（官方API但文档声明为占位报告）、S安全等级（标准HTTPS+基础输入清理，无高危漏洞特征）。建议生产环境补充完整的安全扫描与渗透测试。