Baidu AI Map

百度地图 Agent Plan,立即接入百度地图为 Agent 场景原生设计的地图能力,例如 AI 地点检索、AI 路线规划、地理编码与逆地理编码、天气查询、地图展示等开箱即用的工具。

是一个由百度地图官方提供的 AI 技能,为 Agent 应用场景原生设计的地图能力工具集,支持语义化 AI 搜索、AI 路线规划、地理编码与逆地理编码、天气查询等功能。

使用准则:

API 端点:

所有能力统一使用 Base URL:https://api.map.baidu.com/ SK 凭证安全处理:

优先读取环境变量 BAIDU_MAP_AUTH_TOKEN 如果为空,提示用户前往 https://lbs.baidu.com/apiconsole/agentplan 申请 设置环境变量:export BAIDU_MAP_AUTH_TOKEN="***" 统一鉴权方式(Header 传入):

调用所有 API 时,统一通过 Header 传入:Authorization: Bearer $BAIDU_MAP_AUTH_TOKEN 全局参数与行为约束:

user_raw_request 必须是完整的用户需求,不可压缩为关键词 出现"我附近"等非明确地点时,可根据上下文为用户推理为具体地点名称,但不可对坐标进行推理 保留定语/约束词,例如"评分最高""最近""最便宜""3公里内" 不得编造坐标;center/location/refer_pois 仅可来自用户明确提供或可信来源 统一使用 Header 鉴权:Authorization: Bearer $BAIDU_MAP_AUTH_TOKEN 经纬度至少保留小数点后 6 位 所有工具返回坐标类型统一为 gcj02 工具详解:

Place(语义化AI地点检索):

API:GET /agent_plan/v1/place 参数:user_raw_request(必需)、region(必需)、center(可选)、sort(可选:distance 或 relevance) 示例:curl --get "https://api.map.baidu.com/agent_plan/v1/place" -H "Authorization: Bearer $BAIDU_MAP_AUTH_TOKEN" --data-urlencode "user_raw_request=帮我查一下八达岭长城附近的五星级酒店" --data-urlencode "region=延庆区" --data-urlencode "sort=relevance" Direction(语义化AI路线规划):

API:GET /agent_plan/v1/direction 参数:user_raw_request(必需)、location(必需)、refer_pois(可选) 支持交通方式:驾车、步行、骑行、公交 返回两类结果:路线规划结果(answer_type="gptmodel_navigate")和地点澄清列表(需要用户确认具体地点) 澄清列表消歧流程:展示候选→引导选择→重新规划(携带用户选择的POI信息重新发起请求) Geocoding(地理编码):

API:GET /agent_plan/v1/geocoding 参数:address(必需)、region(可选) Reverse Geocoding(逆地理编码):

API:GET /agent_plan/v1/reverse_geocoding 参数:location(必需:lat,lng 格式坐标,gcj02) Weather(天气查询):

API:GET /agent_plan/v1/weather 参数:region(可选)、location(可选:lat,lng 格式坐标) MapRender(地图展示):

在用户明确表达"在地图上查看"等可视化意图时,生成并打开地图展示链接 参数:resource_key(必需,取自 place 或 direction 接口响应)、open_browser(可选,默认 true) 地图展示链接格式:https://lbs.baidu.com/mapstatic/agentui_resource.html?resource_key=<resource_key>

v1.0.9 2026-07-10
下载