核心用法
baidu-ai-map 是百度地图官方推出的 Agent Plan 技能，为大型语言模型提供直连调用百度地图服务的能力。该技能包含五类核心API：
1. Place（语义化AI地点检索）：支持自然语言搜索POI，如"帮我找北京可带宠物的咖啡馆"，保留完整语义约束（评分最高、最近、3公里内等）。
2. Direction（语义化AI路线规划）：支持智能路线规划，可处理"从故宫到颐和园的驾车路线"等复杂需求，支持POI别名映射消歧。
3. Geocoding（地理编码）：将地址文本转换为经纬度坐标。
4. Reverse Geocoding（逆地理编码）：将坐标转换回结构化地址。
5. Weather（天气查询）：按行政区划或坐标查询实时天气。
所有API统一使用 https://api.map.baidu.com/ 作为基础地址，通过环境变量 BAIDU_MAP_AUTH_TOKEN 进行鉴权，支持GET/POST请求。
显著优点
- T1级可信来源：百度地图官方出品，中国最大的互联网地图服务提供商
- 纯文档型零风险：无可执行代码，仅Markdown文档和API示例，无动态执行风险
- 语义化AI能力：原生支持自然语言理解，无需关键词压缩，保留用户完整意图
- 安全密钥管理：API密钥通过环境变量读取，无私钥硬编码
- HTTPS全链路加密：所有API调用均使用TLS 1.2+加密传输
- 零依赖：无第三方包依赖，无供应链攻击风险
- S+顶级安全认证：六维扫描得分98分，无任何安全漏洞
潜在缺点与局限性
- 地域限制：主要覆盖中国大陆地区，海外数据精度可能受限
- 坐标系锁定：强制使用GCJ-02火星坐标系，与其他坐标系（WGS-84）需转换
- API配额限制：免费额度有限，高频调用需购买商业授权
- 网络依赖：需连接百度地图服务器，离线环境无法使用
- 中文场景优化：英文及其他语言支持相对薄弱
适合人群
- 需要为中国用户提供地图服务的AI应用开发者
- 构建智能出行、本地生活、O2O服务的对话式AI系统
- 需要语义化理解用户位置意图的客服/助理型Agent
- 对安全合规要求严格的企业级应用场景
常规风险
- 密钥泄露风险：需确保
BAIDU_MAP_AUTH_TOKEN环境变量不被意外提交到版本控制 - 位置隐私合规：收集用户位置信息需明确告知并获得授权
- API滥用监控：建议设置调用量告警，防止密钥被盗用导致超额计费
- 服务可用性依赖：百度地图服务中断将直接影响功能可用性