浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

文档全面上新

更科技的视觉体验,更高效的页面结构,快前往体验吧!

体验新版
简介

为便于用户对上传至鹰眼平台的历史轨迹进行检索,增加历史搜索功能。该功能可查询在过去一段时间内,出现在某个空间范围内的终端。例如:搜索昨天下午2:00-3:00途径某地理范围的终端。
注意:该服务为高级付费服务,您可通过[https:https://lbsyun.baidu.com/apiconsole/fankui 申请试用或购买]开通该服务权限。

接口列表
模块 接口名称 功能说明
historysearch createjob 创建搜索任务
getjob 查询搜索
deletejob 删除搜索任务
使用方法
该类接口使用方法为:

第一步:使用createjob接口创建任务
第二步:使用getjob接口查看当前service的所有任务情况
第三步:使用deletejob接口,根据job_id删除任务

接口说明
createjob –- 创建检索任务

在创建一个新的历史轨迹检索任务时,注意:

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二选一)

格式:经度,纬度,半径
其中半径不能超过1000m
示例:119.493328,40.467639,100
around和bounds参数不能都不设置,或都存在

bounds
矩形检索时的矩形范围,注意是左下右上顺序的坐标
string
(around和bounds二选一)

格式:左下角经度,左下角纬度,右上角经度,右上角纬度
其中矩形宽度或者高度,不超过1000m
示例:119.493328,40.467639,119.501234,40.478878
around和bounds参数不能都不设置,或都存在

coord_type 返回的坐标类型
string

可选值为:

gcj02:国测局加密坐标

bd09ll:百度经纬度坐标

该参数仅对国内(包含港、澳、台)轨迹有效。

返回参数
参数名
参数含义 类型 备注
status
状态码 int 0为成功,2为参数错误,4为没有开通权限,详见状态码定义
message
响应信息 string 对status的中文描述
job_id
任务id int 任务id,每个任务的唯一标识


请求示例
oldsearch-detail-1.png
返回结果示例
{
    status: 0,
    message: "成功",
    job_id: 1
}
getjob –- 查询搜索

查询任务池中的任务,任务池中包括以下几类任务:

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

可选值为:
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}.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"}],
}
deletejob –- 删除搜索任务

根据job_id删除任务

请求url
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的中文描述
请求示例
oldsearch-detail-2.png
返回结果示例
{
    status: 0,
    message: "成功",
}
  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消