核心用法
百度地图 Agent Plan Skill 为 AI Agent 提供五类核心地图能力：
1. 语义化地点检索（Place）：支持自然语言搜索，如"帮我找北京可带宠物的咖啡馆"，自动理解"带宠物""评分最高"等约束条件，无需压缩为关键词。支持按距离或相关度排序。
2. 智能路线规划（Direction）：支持驾车、步行、骑行、公交四种交通方式，自动将"打车""公交地铁"等表述映射为可用模式。具备起终点消歧能力，可处理同名地标、模糊起点等场景。
3. 地理编码（Geocoding）：将结构化地址转换为坐标，支持省市区三级区域提示减少歧义。
4. 逆地理编码（Reverse Geocoding）：将坐标转换为地址描述。
5. 天气查询（Weather）：支持按行政区划或坐标查询实时天气。
关键约束：user_raw_request 必须保留完整自然语言，不得压缩为关键词；center/location 坐标禁止编造，需来自用户明确提供或可信来源；坐标统一使用 gcj02 格式，保留 6 位小数；短周期内避免重复请求相同内容以降低 token 消耗。
显著优点
- 语义理解能力强：区别于传统关键词搜索，深度理解约束词（"最近""最便宜""3公里内"）和场景化需求（"可带宠物""适合约会"）。
- 消歧机制完善：
refer_pois参数支持精确地点映射，解决"我家""公司"等别名及同名地标问题。 - 数据权威实时：直接调用百度地图官方数据，POI 覆盖全、更新及时，路线规划考虑实时路况。
- 安全合规：TLS 1.2+ 加密传输，符合 GDPR/CCPA，无敏感信息收集。
潜在缺点与局限性
- 地域限制：主要覆盖中国大陆地区，海外数据精度有限。
- 交通方式限制：仅支持驾车/步行/骑行/公交四种，飞机、火车等长途交通需其他服务。
- Token 成本敏感：文档特别警告"巨额 token 消耗"，高频场景需设计缓存策略。
- 环境变量依赖：必须配置
BAIDU_MAP_AUTH_TOKEN，无免费额度时产生调用成本。 - 坐标系特定：强制 gcj02 坐标系，与 WGS-84 等其他坐标系混用时需转换。
适合人群
- 需要为中国大陆用户提供自然语言交互式地图服务的 AI 应用开发者
- 构建本地生活助手、出行规划 Agent、智能客服的场景
- 对数据权威性和服务稳定性有要求的商业项目
- 需要别名映射（如"我家""公司"）增强用户体验的产品
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| API 密钥泄露 | `BAIDU_MAP_AUTH_TOKEN` 泄露可能导致配额盗用 | 使用秘密管理工具，定期轮换密钥 |
| 坐标精度损失 | 经纬度截断导致定位偏移 | 严格保留 6 位小数 |
| Token 消耗过高 | 重复请求或响应裁剪不当 | 避免正则裁剪响应，设计请求缓存 |
| 隐私合规 | 位置数据属于敏感信息 | 明确告知用户，获取授权 |
| 服务依赖 | 百度 API 可用性影响功能 | 设计降级策略，超时熔断 |
配置要求
# 申请地址：https://lbs.baidu.com/apiconsole/agentplan export BAIDU_MAP_AUTH_TOKEN="你的SK"