核心用法
百度地图 Agent Plan Skill 为 AI Agent 场景原生设计,提供五大核心地图能力:
1. AI 地点检索(Place) —— 支持自然语言语义搜索,如"帮我找北京可带宠物的咖啡馆",自动理解"带宠物""评分最高"等约束条件,返回结构化 POI 列表。
2. AI 路线规划(Direction) —— 支持驾车、步行、骑行、公交四种交通方式,可处理沿途搜索(如"顺路买杯咖啡"),具备起点/终点澄清机制,避免同名地点歧义。
3. 地理编码(Geocoding) —— 将地址文本转换为 gcj02 坐标,支持区域提示减少歧义。
4. 逆地理编码(Reverse Geocoding) —— 将坐标转换为结构化地址信息。
5. 天气查询(Weather) —— 支持按行政区划或坐标查询实时天气。
接入方式极为简洁:仅需环境变量 BAIDU_MAP_AUTH_TOKEN,所有 API 通过 Header Authorization: Bearer 统一鉴权,纯 curl 调用无代码依赖。
显著优点
- 零门槛接入:无需百度地图开发者资质,个人/团队即刻使用企业级地图能力
- 语义化原生:专为 LLM 场景设计,
user_raw_request保留完整自然语言,非关键词压缩,AI 意图理解准确率大幅提升 - 智能歧义消解:路线规划自动识别起点/终点模糊场景,返回候选列表引导用户确认
- 可视化联动:支持
resource_key拼接跳转链接,一键在浏览器打开地图可视化 - 安全架构优异:纯 Markdown 文档结构,无独立可执行代码,依赖系统 curl 工具,零供应链攻击面
潜在缺点与局限性
- 地域局限:数据覆盖以中国大陆为主,海外 POI 与路线规划能力有限
- 交通方式受限:仅支持驾车/步行/骑行/公交,暂不支持网约车、航班、火车等跨城交通
- 坐标系锁定:强制 gcj02 坐标系,与 WGS-84 混用时需额外转换
- Token 成本敏感:文档明确警示禁止正则裁剪响应后重复推断,否则将导致"巨额 token 消耗"
- 可视化触发严格:仅当用户明确表达"在地图上看"等意图时才返回跳转链接,模糊表达不触发
适合人群
- 需要快速集成地图能力的 AI Agent 开发者
- 构建本地生活、出行助手、智能客服等场景的产品团队
- 缺乏地图开发者资质但需企业级数据质量的初创团队
- 对供应链安全敏感、要求零代码执行风险的金融/政务场景
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 数据隐私 | 低 | 位置数据经 HTTPS 加密传输至百度官方,无第三方中转 |
| 凭证泄露 | 低 | 强制环境变量读取,无硬编码风险;需避免日志打印 |
| 服务依赖 | 中 | 依赖百度地图 API 可用性与商业策略稳定性 |
| 合规风险 | 低 | 位置信息处理需符合《个人信息保护法》告知义务 |