全部服务产品
开发者频道
定价
登录
简介

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

接口列表
模块接口名称功能说明
historysearchcreatejob 创建搜索任务
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个则返回创建失败,请等待现有的任务处理完之后再创建新的任务。

请求URL

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

格式:经度,纬度,半径
其中半径不能超过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

默认值:bd09ll
该字段用于控制返回结果中的坐标类型。可选值为:
gcj02:国测局加密坐标
bd09ll:百度经纬度坐标
该参数仅对国内(包含港、澳、台)轨迹有效,海外区域轨迹均返回 wgs84坐标系

返回参数
参数名字段含义类型备注
status状态码int返回状态,0为成功
message响应信息string对status的中文描述
job_id任务 idint任务id,每个任务的唯一标识
请求示例
返回示例
{
"status": 0,
"message": "成功",
"job_id" : 1
}
getjob–-查询搜索

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

1. 已创建尚未开始执行的任务
2. 正在执行的任务
3. 已完成的任务,但完成时间不超过48小时(注:已完成的任务会在48小时之后自动清理)已完成的任务会返回file_url,将地址粘贴至浏览器或使用其他下载方 法,即可获得结果文件。当file_url显示no result的时候,表明没有查询到entity。

请求URL

https://yingyan.baidu.com/api/v3/historysearch/getjob
//GET请求

请求参数
参数名称字段含义数据类型是否必填备注
ak

用户的AK

string
service_id

service的ID,service 的唯一标识

int在轨迹管理台创建鹰眼服务时,系统返回的 service_id
返回参数
参数名称字段含义字段类型备注
status状态码int0为成功,2为参数错误,4为没有开通权限,详见状态码定义
message响应信息string对status的中文描述
job任务
job_id任务idint任务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轨迹数据下载链接stringjob_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"}],
}
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每个任务的唯一标识
sn

用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。SN计算方法

string
返回参数
参数名字段含义类型备注
status状态码int0为成功,详见 状态码定义
message响应信息string对status的中文描述
请求示例
返回示例
{
"status": 0,
"message": "成功",
}

上一篇

批量导出轨迹

下一篇

自定义属性字段

本篇文章对您是否有帮助?