yingyan

简介

为便于用户对上传至鹰眼平台的历史轨迹进行检索，增加历史搜索功能。该功能可查询在过去一段时间内，出现在某个空间范围内的终端。例如：搜索昨天下午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，每个任务的唯一标识

请求示例

返回结果示例

{
    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的中文描述

请求示例

返回结果示例

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

WebAPI文档全面上新