核心用法
baidu-ai-map 是百度地图官方推出的 Agent Plan 服务 Skill，提供五种核心地图能力，全部通过语义化自然语言交互实现：
1. Place（语义化AI地点检索）：支持自然语言描述需求（如"帮我找北京可带宠物的咖啡馆"），自动理解约束条件（评分最高、最近、最便宜、3公里内等），返回精准POI结果
2. Direction（语义化AI路线规划）：支持驾车、步行、骑行、公交四种交通方式，可处理起终点歧义澄清，自动推理最优路径
3. Geocoding（地理编码）：将文本地址转换为坐标
4. Reverse Geocoding（逆地理编码）：将坐标转换为结构化地址
5. Weather（天气查询）：按坐标或行政区查询天气
所有API统一使用 https://api.map.baidu.com/ 作为Base URL，通过 baidu_map_auth_token 参数鉴权，凭证优先从环境变量 BAIDU_MAP_AUTH_TOKEN 读取。
显著优点
- AI原生设计：不同于传统关键词搜索，全程支持自然语言语义理解，大幅降低使用门槛
- 权威数据：百度地图国内POI覆盖最全，路况数据实时更新
- 智能歧义处理：自动识别同名地点、模糊位置，支持起终点澄清交互
- 安全合规：纯Markdown文档型Skill，无动态代码执行；凭证通过环境变量管理，无硬编码风险
- 高精度坐标：强制要求经纬度保留6位小数，统一GCJ02坐标系
- 防滥用机制：明确禁止正则裁剪响应后推断字段，避免巨额token消耗
潜在缺点与局限性
- 地域限制：主要覆盖中国大陆地区，海外数据相对薄弱
- 交通方式有限：目前仅支持驾车、步行、骑行、公交，地铁/打车等场景需语义改写
- 坐标获取依赖：
center、location等参数禁止推测编造，需用户明确提供或前置调用Place/Geocoding获取 - 网络依赖：所有能力均需联网调用，无离线缓存机制
- 商业场景限制：免费额度有限，高频调用需申请商业授权
适合人群
- 需要集成地图能力的AI Agent开发者
- 追求自然语言交互体验的终端用户
- 对数据准确性和服务稳定性有严格要求的企业客户
- 需要快速构建LBS（基于位置服务）应用的创业团队
常规风险
- 凭证泄露风险：虽采用环境变量存储，但仍需确保运行环境安全，避免token被恶意提取
- API配额耗尽：高频场景下可能触发限流，需合理设计缓存策略
- 隐私合规：处理用户位置数据时需注意GDPR/CCPA等法规要求，尽管本Skill本身不主动收集隐私
- 语义理解偏差：极端复杂或方言表述可能导致意图识别失败
安全认证亮点
经CLS-Certify v2.1.0扫描，本Skill获得 S级（95分） 安全评级：静态分析95分（无危险函数、无硬编码密钥）、动态分析100分（无可执行代码）、依赖审计100分（零第三方依赖）、网络分析90分（仅调用百度官方API）、隐私合规95分（环境变量凭证管理）。