为便于用户对上传至鹰眼平台的历史轨迹进行检索,增加历史搜索功能。该功能可查询在过去一段时间内,出现在某个空间范围内的终端。例如:搜索昨天下午2:00-3:00途径某地理范围的终端。注意:该服务为高级付费服务,您可通过开通该服务权限。
模块 | 接口名称 | 功能说明 |
---|---|---|
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时间戳 | 是 | 注:结束时间需比当前最新时间小12小时(即只能下载12小时以前的轨迹),且结束时间和起始时间差在24小时之内(即一次只能下载24小时区间内的轨迹)。 |
around | 圆形检索时的圆心及半径 | string | 否(around和bounds二选一) | 格式:经度,纬度,半径 |
bounds | 矩形检索时的矩形范围,注意是左下右上顺序的坐标 | string | 否(around和bounds二选一) | 格式:左下角经度,左下角纬度,右上角经度,右上角纬度 |
coord_type | 返回的坐标类型 | string | 否 | 默认值:bd09ll |
参数名 | 字段含义 | 类型 | 备注 |
---|---|---|---|
status | 状态码 | int | 返回状态,0为成功 |
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 | |||||
latitude | 纬度 | double | |||||
radius | 半径 | int | 单位:米 | ||||
bounds | 矩形检索参数 | object | |||||
ll | 左下角信息 | object | |||||
longitude | 经度 | double | |||||
latitude | 纬度 | double | |||||
rt | 右上角信息 | object | |||||
longitude | 经度 | double | |||||
latitude | 纬度 | double | |||||
coord_type | 返回的坐标类型 | string | 可选值为: gcj02:国测局加密坐标。 bd09ll:百度经纬度坐标。 该参数仅对国内(包含港、澳、台)轨迹有效。 | ||||
create_time | 任务创建的格式化时间 | string | 该时间为服务端时间 | ||||
modify_time | 任务创建的格式化时间 | string | 该时间为服务端时间 | ||||
job_status | 任务创建的格式化时间 | string | 取值范围: waiting:待处理; running:正在执行; done:已完成,可下载结果文件 | ||||
file_url | 轨迹数据下载链接 | string | job_status为 done 时,将会生成结果文件的下载链接,开发者可通过该链接下载数据文件。 注: 1、已完成的任务会在48小时之后自动清理,请及时下载。 2、当该自动显示为no result时,表示没有检索到数据。 |
1. 导出文件名为格式为:service_id_job_id.zip(例如:135252_10.zip)
2. 使用zip解压工具解压可以得到文件:service_id_job_id.json(例:135252_10.json)
3. 文件中每行文本代表一条轨迹数据,json格式,其中:
https://yingyan.baidu.com/api/v3/historysearch/getjob?ak=<用户ak>&service_id=<用户service_id>
{"status":0,"message":"成功","total":2,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 | 是 | 每个任务的唯一标识 |
sn | 用户的权限签名,若用户所用ak的校验方式为sn校验时该参数必须。sn计算方法 | string | 否 |
参数名 | 字段含义 | 类型 | 备注 |
---|---|---|---|
status | 状态码 | int | 0为成功,详见 状态码定义 |
message | 响应信息 | string | 对status的中文描述 |
{"status":0,"message":"成功",}
上一篇
下一篇
本篇文章对您是否有帮助?