百度地图开放平台

所有文档

POI智能提取

更新时间: 2026/09/10 14:35
提交问题
API服务地址

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

提交文本或图片,服务返回本次会话标识 session_id 与地图结果标识 map_id,供后续轮询与回查。

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

ak

开放平台申请的 AK

string

id

设备 ID

string

session_id

会话标识

string

不填则返回新的 session_id;填写则沿用该会话

map_id

地图结果 ID

string

每次提交都会返回新的 map_id。若传入已有 map_id,会将本次识别的点位合并到该结果中

msg_type

消息类型

string

text:文本;image:图片

text_content

文本内容,长度不超过 2000

string

msg_type=text 时必填

image_file_name

图片文件名

string

msg_type=image 时必填。需包含完整文件名与后缀,例如 4j346jjbnvyfduhy2dsdtt5y5.jpg

image_content

图片 base64 内容

string

msg_type=image 时与 image_url 二选一。需包含 MIME 类型,图片不超过 4MB。例如 data:image/jpeg;base64,/9j/4AAQ...

image_url

图片 URL

string

msg_type=image 时与 image_content 二选一,同时传递会报错。需为完整域名 URL,不含 IP、端口,图片不超过 5MB

请求示例:

{
"ak": "您的密钥",
"id": "device-001",
"msg_type": "text",
"text_content": "周末去故宫和颐和园,顺便在南锣鼓巷吃饭。"
}
返回参数
{
"log_id": "440625975",
"message": "ok",
"result": {
"session_id": "9f068b8cc89a01a58273147ef43425aa",
"map_id": "b17d305dc31f17d416d53b37870cf957"
},
"status": 0
}
参数名称类型含义是否必定返回说明

status

int

服务响应状态

见下方服务状态码

message

string

状态信息

result

object

业务数据

result.session_id

string

会话 ID

请求未传 session_id 时会开启新会话

result.map_id

string

地图结果 ID

用于轮询后的回查与刷新

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

0

ok

请求成功

-1

参数错误

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

-2

内部错误

服务内部异常

正数

开平通用状态码

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

上一篇

使用准备

下一篇

轮询查询回答
本篇文章对您是否有帮助?