为便于用户对上传至鹰眼平台的历史轨迹进行检索,增加历史搜索功能。该功能可查询在过去一段时间内,出现在某个空间范围内的终端。例如:搜索昨天下午2:00-3:00途径某地理范围的终端。
注意:该服务为高级付费服务,您可通过[https:https://lbsyun.baidu.com/apiconsole/fankui 申请试用或购买]开通该服务权限。
模块 | 接口名称 | 功能说明 |
---|---|---|
historysearch | createjob | 创建搜索任务 |
getjob | 查询搜索 | |
deletejob | 删除搜索任务 |
第一步:使用createjob接口创建任务
第二步:使用getjob接口查看当前service的所有任务情况
第三步:使用deletejob接口,根据job_id删除任务
在创建一个新的历史轨迹检索任务时,注意:
1. 只能检索距当前时间6小时之前的轨迹,例如:2021-11-15 10:00创建的任务只能检索2021-11-15 4:00之前产生的轨迹。
2. 检索的时间区间不超过24小时,即结束时间和起始时间差在24小时之内。
3. 一个开发者同时只允许存在10个未完成任务,超过10个则返回创建失败,请等待现有的任务处理完之后再创建新的任务。
https://yingyan.baidu.com/api/v3/historysearch/createjob //POST请求
参数名 | 参数含义 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
ak | 用户的AK | string | 是 | |
service_id | service的ID,service 的唯一标识。 | int | 是 | 在轨迹管理台创建鹰眼服务时,系统返回的 service_id |
start_time | 轨迹起始时间 | UNIX时间戳 | 是 | |
end_time | 轨迹结束时间 | UNIX时间戳 | 是 | 注:结束时间需比当前最新时间小6小时(即只能下载6小时以前的轨迹),且结束时间和起始时间差在24小时之内(即一次只能下载24小时区间内的轨迹) |
around | 圆形检索时的圆心及半径 | string | 否 (around和bounds二选一) |
格式:经度,纬度,半径 |
bounds |
矩形检索时的矩形范围,注意是左下右上顺序的坐标 |
string | 否 (around和bounds二选一) |
格式:左下角经度,左下角纬度,右上角经度,右上角纬度 |
coord_type | 返回的坐标类型 |
string |
否 |
可选值为:
gcj02:国测局加密坐标 bd09ll:百度经纬度坐标 该参数仅对国内(包含港、澳、台)轨迹有效。 |
参数名 |
参数含义 | 类型 | 备注 | |||
---|---|---|---|---|---|---|
status |
状态码 | int | 0为成功,2为参数错误,4为没有开通权限,详见状态码定义 | |||
message |
响应信息 | string | 对status的中文描述 | |||
job_id |
任务id | int | 任务id,每个任务的唯一标识 |

{ status: 0, message: "成功", job_id: 1 }
查询任务池中的任务,任务池中包括以下几类任务:
1. 已创建尚未开始执行的任务
2. 正在执行的任务
3. 已完成的任务,但完成时间不超过48小时(注:已完成的任务会在48小时之后自动清理)已完成的任务会返回file_url,将地址粘贴至浏览器或使用其他下载方 法,即可获得结果文件。当file_url显示no result的时候,表明没有查询到entity。
https://yingyan.baidu.com/api/v3/historysearch/getjob //GET请求
参数名 | 参数含义 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
ak | 用户的AK | string | 是 | |
service_id | service的ID,service 的唯一标识。 | int | 是 | 在轨迹管理台创建鹰眼服务时,系统返回的 service_id |
参数名 |
参数含义 | 类型 | 备注 | ||||
---|---|---|---|---|---|---|---|
status |
状态码 | int | 0为成功,2为参数错误,4为没有开通权限,详见状态码定义 | ||||
message |
响应信息 | string | 对status的中文描述 | ||||
job |
任务 | ||||||
|
job_id | 任务id | int | 任务id,每个任务的唯一标识 | |||
|
start_time | 轨迹起始任务 | UNIX时间戳 | ||||
|
end_time | 轨迹结束任务 | UNIX时间戳 | ||||
|
around | 圆形检索参数 | UNIX时间戳 | ||||
|
|
center | 圆心 | object | |||
|
|
|
longitude | 经度 | double | ||
|
|
|
longitude | 纬度 | double | ||
|
|
radius | 半径 | int | 单位:米 | ||
|
bounds | 矩形检索参数 | object | ||||
|
|
ll | 左下角信息 | object | |||
|
|
|
longitude | 经度 | double | ||
|
|
|
longitude | 纬度 | double | ||
|
|
rt | 右上角信息 | object | |||
|
|
|
longitude | 经度 | double | ||
|
|
|
longitude | 纬度 | double | ||
|
coord_type | 返回的坐标类型 | string |
可选值为: | |||
|
create_time | 任务创建的格式化时间 | string | 该时间为服务端时间 | |||
|
modify_time | 任务创建的格式化时间 | string | 该时间为服务端时间 | |||
|
job_status | 任务当前的执行状态 | string |
取值范围: | |||
|
file_url | 轨迹数据下载链接 | string |
job_status为 done 时,将会生成结果文件的下载链接,开发者可通过该链接下载数据文件。 |
导出文件说明:
1. 导出文件名为格式为:{service_id}_{job_id}.zip(例如:135252_10.zip)
2. 使用zip解压工具解压可以得到文件:{service_id}_{job_id}.txt(例:135252_10.txt)
3. 文件中每行文本代表一个entity name
https://yingyan.baidu.com/api/v3/historysearch/getjob?ak=<用户ak>&service_id=<用户service_id>
{ status: 0, message: "成功", total: 1, jobs: [{ "job_id":1,"service_id":230144,"start_time":1639411200, "end_time":1639422000,"around":{"center":{"longitude":119.493328,"latitude":40.467639},"radius":100},"coord_type" :"gcj02","create_time":"20211215192540","modify_time":"20211215192552","job_status":"done", "file_url":"no result"}], }
根据job_id删除任务
https://yingyan.baidu.com/api/v3/historysearch/deletejob //POST请求
参数名 | 参数含义 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
ak | 用户的AK | string | 是 | |
service_id | service的ID,service 的唯一标识。 | int | 是 | 在轨迹管理台创建鹰眼服务时,系统返回的 service_id |
job_id | 任务id | int | 是 | 每个任务的唯一标识 |
参数名 | 参数含义 | 类型 | 备注 |
---|---|---|---|
status | 状态码 | int | 0为成功,详见状态码定义 |
message | 响应信息 | string | 对status的中文描述 |

{ status: 0, message: "成功", }