核心用法
百度地图 Agent Plan 是一套专为 AI Agent 场景设计的地图能力接入方案，无需成为百度地图开发者即可开箱即用。该 Skill 封装了五大核心 API：
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)：按区域或坐标查询天气
所有 API 统一通过 Header Authorization: Bearer $BAIDU_MAP_AUTH_TOKEN 鉴权，需用户前往 百度地图 Agent Plan 申请 SK（Service Key）。
显著优点
- 原生语义理解：无需将用户需求压缩为关键词，支持完整自然语言输入，AI 自动解析意图和约束条件
- 零开发成本：无需注册百度地图开发者账号，申请 SK 后即可通过 curl 直接调用
- 大模型友好：专为 Agent 场景设计，返回结构化数据便于模型推理
- 权威数据：依托百度地图海量 POI 数据和实时路况
- 安全合规：凭证通过环境变量管理，HTTPS 加密传输，符合 GDPR 数据最小化原则
潜在缺点与局限性
- 交通方式限制：仅支持驾车、步行、骑行、公交四类，其他方式（如打车、地铁）需改写为近似类型
- 坐标依赖严格：
center/location/refer_pois禁止推测或编造，无可靠来源时需先调用 geocoding 获取 - 地域局限：百度地图数据覆盖以中国大陆为主，海外场景支持有限
- Token 管理成本：用户需手动申请、配置和保管 SK，存在泄露风险
适合人群
- 需要快速接入地图能力的 AI Agent 开发者
- 构建本地生活、出行、旅游类应用的团队
- 希望降低地图服务集成门槛的产品原型验证
- 对数据合规性有要求的 B 端应用场景
常规风险
- 凭证泄露：环境变量配置不当可能导致 SK 暴露，建议加强 Token 安全使用教育
- API 限流：高频调用可能触发百度地图限流策略，需设计缓存和重试机制
- 数据隐私：位置信息传输至百度服务器，虽符合 GDPR，但敏感场景建议增加用户授权确认
- 版本不一致：当前文档版本号（1.0.0）与元数据版本（1.0.6）存在差异，可能导致混淆