核心用法
百度地图 Agent Plan 是一套面向大模型的语义化地图服务接口,通过 curl 调用五类能力:
| 工具 | 用途 | 关键参数 |
|------|------|---------|
| `place` | 语义化 AI 地点检索 | `user_raw_request`, `region`, `center`, `sort` |
| `direction` | 智能路线规划 | `user_raw_request`, `location`, `refer_pois` |
| `geocoding` | 地址转坐标 | `address`, `region` |
| `reverse_geocoding` | 坐标转地址 | `location` |
| `weather` | 天气查询 | `region` 或 `location` |
鉴权方式:统一 Header Authorization: Bearer $BAIDU_MAP_AUTH_TOKEN,凭证通过环境变量注入,禁止硬编码。
关键设计原则
user_raw_request必须保留完整语义,不可压缩为关键词,需保留"评分最高""3公里内"等约束词- 经纬度精度≥6位小数,统一使用
gcj02坐标系 - 禁止编造坐标,无可靠来源时需先调用
geocoding/place获取 - 支持"我附近"等模糊位置的上下文推理,但不对坐标进行推测
显著优点
1. 语义化交互:告别传统 POI ID 检索,直接用自然语言描述需求,如"帮我找北京可带宠物的咖啡馆"
2. 智能消歧:自动处理同名地点、别名映射(如"我家"),支持起终点澄清交互
3. 交通方式推理:自动将"打车"改写为"驾车",扩展至驾车/步行/骑行/公交四类标准模式
4. 零代码攻击面:纯 Markdown 文档型 skill,无可执行代码,无第三方依赖
5. 企业级安全:百度官方维护,TLS 1.2+ 加密,通过 CLS S+ 级认证(98分)
潜在缺点与局限性
- 地域覆盖:百度地图数据以中国大陆为主,海外覆盖弱于 Google Maps
- 交通方式限制:仅支持驾车、步行、骑行、公交,不支持地铁/航班/火车等精细规划
- Token 成本:规则明确禁止正则裁剪响应后推断,需完整处理返回,高频调用可能产生较大 token 消耗
- 坐标系绑定:强制
gcj02,与wgs84系统需额外转换 - 申请门槛:需注册百度地图开放平台,通过 Agent Plan 审核获取 SK
适合人群
- 需要为中国大陆用户提供地图服务的 AI 应用开发者
- 追求语义化交互、降低 POI 维护成本的团队
- 对安全合规要求严格的企业级场景(已通过 GDPR/CCPA 合规检测)
常规风险
| 风险点 | 说明 | 缓解措施 |
|--------|------|---------|
| 凭证泄露 | SK 泄露可能导致 API 滥用 | 严格环境变量管理,禁止提交到版本控制 |
| 位置隐私 | 需获取用户精确坐标 | 遵循最小化原则,仅请求必要精度 |
| API 稳定性 | 依赖百度官方服务可用性 | 关注官方公告,实现降级策略 |
| 响应解析 | 禁止正则裁剪后推断字段 | 完整解析响应,基于结果直接推理 |
本 skill 是当前中文语境下最安全、最成熟的地图 Agent 解决方案之一,尤其适合企业级 AI 应用集成。