核心用法
baidu-ai-map 是百度地图官方推出的 Agent Plan 技能，为 LLM 提供五类核心地理服务能力：
1. AI地点检索 (/agent_plan/v1/place)：支持自然语言语义搜索，如"帮我找北京可带宠物的咖啡馆"，保留约束词（评分最高、最近、3公里内等），支持按距离或相关度排序。
2. AI路线规划 (/agent_plan/v1/direction)：支持驾车、步行、骑行、公交四种交通方式的智能规划，可自动推理起点歧义，支持"我家"等别名映射。
3. 地理编码 (/agent_plan/v1/geocoding)：将地址转换为经纬度坐标。
4. 逆地理编码 (/agent_plan/v1/reverse_geocoding)：将坐标转换为结构化地址。
5. 天气查询 (/agent_plan/v1/weather)：按行政区划或坐标查询天气。
所有接口统一使用 Authorization: Bearer $BAIDU_MAP_AUTH_TOKEN Header 鉴权，坐标系统采用 gcj02，经纬度保留 6 位小数。
显著优点
- 官方权威：来自百度地图官方 GitHub 组织 (baidu-maps)，T1 级可信来源，数据准确性与服务稳定性有保障。
- 语义化智能：区别于传统关键词搜索，支持完整自然语言理解，自动识别约束条件（距离、评分、价格等）。
- 安全设计：凭证仅通过环境变量传递，无硬编码风险；纯 Markdown 技能，无本地代码执行。
- 合规传输：全链路 HTTPS/TLS 1.2+，Header 鉴权机制符合 OAuth2 最佳实践。
- 功能完整：覆盖"搜索-编码-规划-天气"完整 LBS 场景，满足出行、生活、物流等多领域需求。
潜在缺点与局限性
- 地域限制：主要覆盖中国大陆地区，海外数据精度与覆盖度有限。
- 交通方式有限：路线规划仅支持驾车、步行、骑行、公交，不支持地铁细节、航班、轮渡等。
- Token 依赖：需自行申请百度地图 SK，新用户存在门槛；API 有调用配额限制，高频场景需商业授权。
- 坐标系统锁定：强制使用
gcj02坐标系，如需与其他系统（WGS84）对接需额外转换。 - 无离线能力：纯云端 API，弱网或无网环境不可用。
适合人群
- 需要为中国用户提供地理位置智能服务的应用开发者
- 构建旅行规划、本地生活、物流配送等场景的 AI Agent
- 希望快速接入权威地图数据而无需自建 POI 数据库的团队
常规风险
- 凭证泄露风险：若环境变量配置不当（如提交至代码仓库），可能导致 SK 泄露。建议配合
.gitignore与密钥管理服务使用。 - 隐私合规注意：传递用户精确坐标时需获得用户授权，遵守《个人信息保护法》及位置信息相关法规。
- API 稳定性依赖：服务可用性绑定百度地图云服务，建议生产环境实施熔断与降级策略。