历史轨迹搜索 | 百度地图API SDK

所有文档

鹰眼轨迹服务

更新时间: 2026/03/20 16:02

简介

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

接口列表

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

API服务地址

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	任务 id	int	任务id，每个任务的唯一标识

请求示例

返回示例


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

getjob–-查询搜索

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

API服务地址

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

请求参数

参数名称	字段含义	数据类型	是否必填	备注
参数名称	字段含义	数据类型	是否必填	备注
ak	用户的AK	string	是
service_id	service的ID，service 的唯一标识	int	是	在轨迹管理台创建鹰眼服务时，系统返回的 service_id

返回参数

参数名称					字段含义	字段类型	备注
参数名称	返回参数2	返回参数3	返回参数4	返回参数5	字段含义	字段类型	备注
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"}],
}

deletejob –- 删除搜索任务

根据job_id删除任务

API服务地址

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": "成功",
}

批量导出轨迹

自定义属性字段

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