百度地图开放平台

所有文档

POI智能提取

更新时间: 2026/09/10 14:35
轮询查询回答
API服务地址

https://api.map.baidu.com/api_mark/v1/round
Content-Type: application/x-www-form-urlencoded

建议约 1 秒轮询一次,答案产出时间大约在 10 秒以内。可能一次性返回该会话下此前多次 submit 的答案,返回顺序不保证与提交时序相同。

请求参数
参数名称含义类型是否必填说明

ak

开放平台申请的 AK

string

id

用户 ID,尽量传设备 ID

string

session_id

submit 返回或传入的会话 ID

string

请求示例:

{
"ak": "您的密钥",
"id": "device-001",
"session_id": "9f068b8cc89a01a58273147ef43425aa"
}
返回参数
{
"log_id": "2199645695",
"message": "ok",
"result": {
"data": [
{
"answer_type": "text",
"create_time": "2024-04-11 20:40:21",
"text": {
"content": "抱歉,没有找到对应地点;请尝试补充更明确的地点描述后再试。"
}
},
{
"answer_type": "link",
"create_time": "2024-04-10 20:22:26",
"link": {
"title": "地图已生成,点我查看",
"desc": "为您找到3个地点",
"jump_url": "https://map.baidu.com/mark-map/?id=example",
"image": "https://now.bdstatic.com/stash/v1/22ce534/h5/569bc67/mark-map/mark-welcom.png",
"poi": [
{
"uid": "06d2dffda107b0ef89f15db6",
"name": "故宫博物院",
"location": {
"x": 12958109.75,
"y": 4827238.08
},
"admin_info": {
"province_name": "北京市",
"city_name": "北京市",
"area_name": "东城区",
"country_name": "中国"
}
},
{
"uid": "2fd2beabe34a80517adbd220",
"name": "八达岭长城",
"location": {
"x": 12915880.59,
"y": 4890848.68
}
}
]
}
}
]
},
"status": 0
}

无数据时:

{
"log_id": "2199645693",
"message": "ok",
"result": null,
"status": 0
}
参数名称类型含义是否必定返回说明

status

int

服务响应状态

0 成功,非 0 失败

message

string

状态信息

result

object

业务数据

无数据时为 null

result.data

array

回答列表

result.data[].answer_type

string

回答类型

link 或 text

result.data[].create_time

string

消息创建时间

result.data[].link.title

string

标题

answer_type=link 时

result.data[].link.desc

string

说明

如「为您找到 N 个地点」

result.data[].link.jump_url

string

地图跳转链接

result.data[].link.image

string

封面图

result.data[].link.poi

array

POI 列表

poi[].uid

string

POI uid

poi[].name

string

POI 名称

poi[].location.x / y

float

POI 坐标

poi[].admin_info

object

省市区信息

不存在时为 null

admin_info.province_id / province_name

int / string

省份

admin_info.city_id / city_name

int / string

城市

admin_info.area_id / area_name

int / string

区县

admin_info.town_id / town_name

int / string

乡镇

admin_info.country_name

string

国家

poi[].price

float

景区门票价格

为空时为 0

poi[].shop_hours

string

景区营业时间

为空时为空字符串

result.data[].text.content

string

文本内容

answer_type=text 时

服务状态码
返回码定义说明

0

ok

请求成功

-1

参数错误

必填参数缺失、参数过长等

-2

内部错误

服务内部异常

正数

开平通用状态码

权限、配额、AK 等,含义与 WebAPI 通用状态码一致

上一篇

提交问题

下一篇

重新获取POI结果
本篇文章对您是否有帮助?