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

文档全面上新

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

体验新版
（以“{{yingyan-sidebar}} ==简介== 批量导出类接口为开发者提供批量导出历史轨迹数据的功能，该类接口根据时间区间将轨迹数据打包...”为内容创建页面）
 
 
（未显示1个用户的19个中间版本）
第1行： 第1行：
 
{{yingyan-sidebar}}
 
{{yingyan-sidebar}}
−
==简介==
+
<div class="bluetitle"><div class="services-title-text service-page-anchor">简介</div></div><div class="serve-explain-text">批量导出类接口提供批量导出轨迹数据功能，该类接口将一段时间内的轨迹数据打包成文件，生成下载链接供开发者下载。该类接口包括三个 API：</div>
−
批量导出类接口为开发者提供批量导出历史轨迹数据的功能，该类接口根据时间区间将轨迹数据打包成文件，并生成文件下载链接供下载。该类接口包括三个 API：
+
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
−
!width="100"| 模块
+
|-
−
!width="200"| 接口名称
+
! width="100" | 模块
−
!width="300"| 功能说明
+
! width="200" | 接口名称
−
 
+
! width="300" | 功能说明
 
|-
 
|-
 
| rowspan="3" | export
 
| rowspan="3" | export
 
| createjob
 
| createjob
−
| 创建一个任务，该任务完成后将导出的文件和下载地址
+
| 创建一个任务，该任务完成后将返回文件下载地址，供开发者下载
 
|-
 
|-
 
| deletejob
 
| deletejob
−
| 删除任务
+
| 删除任务
 
|-
 
|-
 
| getjob
 
| getjob
 
| 查询任务，将返回任务状态和文件下载地址
 
| 查询任务，将返回任务状态和文件下载地址
 
|}
 
|}
−
 
+
<div class="bluetitle"><div class="services-title-text service-page-anchor">使用方法</div></div><div class="serve-explain-text">
−
==使用说明==
+
该类接口使用方法为：
−
 
+
−
批量导出接口类接口使用步骤为：
+
−
 
+
  
 
第一步：使用 createjob接口创建任务，获得任务 id
 
第一步：使用 createjob接口创建任务，获得任务 id
−
 
  
 
第二步：使用 getjob 接口定期查询任务状态，一旦返回值中的 job_status 字段为"done"时，取出 file_url 字段中的下载链接，开发者可使用自己熟悉的下载工具从该链接下载轨迹文件。
 
第二步：使用 getjob 接口定期查询任务状态，一旦返回值中的 job_status 字段为"done"时，取出 file_url 字段中的下载链接，开发者可使用自己熟悉的下载工具从该链接下载轨迹文件。
−
 
  
 
'''注意事项'''：
 
'''注意事项'''：
第35行： 第29行：
  
  
−
2.下载文件生成成功后，开发者需尽快下载文件，鹰眼将在48小时后删除服务端的文件
+
2.下载文件生成成功后，开发者需尽快下载文件，鹰眼将在48小时后删除服务端的文件</div><div class="bluetitle"><div class="services-title-text service-page-anchor">坐标系说明</div></div><div class="serve-explain-text">
−
 
+
−
==坐标系说明==
+
−
 
+
 
目前中国主要有以下三种坐标系：
 
目前中国主要有以下三种坐标系：
  
 +
WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系
  
−
WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
+
GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系
−
 
+
−
 
+
−
GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
+
−
 
+
  
 
BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标
 
BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标
−
 
  
 
非中国地区地图，统一使用WGS84坐标
 
非中国地区地图，统一使用WGS84坐标
  
−
 
+
鹰眼 Web服务API v3.0的默认输入输出坐标为百度经纬度坐标系（bd09ll），同时可通过"coord_type"
−
{{red|鹰眼 Web服务API v3.0的默认输入输出坐标为百度经纬度坐标系（bd09ll），同时可通过"coord_type"
+
，"coord_type_input"，"coord_type_output"（以各服务参数介绍为准）控制输入输出的坐标类型，鹰眼将自动完成转换。</div><div class="bluetitle"><div class="services-title-text service-page-anchor">接口说明</div></div><div class="separate-title service-page-anchor">createjob—— 创建任务</div><div class="serve-explain-text">
−
，"coord_type_input"，"coord_type_output"（以各服务参数介绍为准）控制输入输出的坐标类型，鹰眼将自动完成转换。}}
+
−
 
+
−
==createjob—— 创建任务==
+
−
===接口说明===
+
 
创建一个新的轨迹数据导出任务，下载该service 内一段时间内的全部轨迹。
 
创建一个新的轨迹数据导出任务，下载该service 内一段时间内的全部轨迹。
  
−
{{red|注意：}}
+
注意：
  
−
{{red|1. 每一个任务最多下载一天的全量轨迹。例如，若下载7天的轨迹，则需创建7个任务}}
+
1. 只能下载距当前时间6小时之前的轨迹，例如：2017-8-7 10:00创建的下载任务只能下载2017-8-7 4:00之前产生的轨迹
  
−
{{red|2. 每个service_id同时只允许存在10个未完成任务，超过10个则返回创建失败，请等待现有的任务处理完之后再创建新的任务}}
+
2. 每一个任务最多下载24小时时长的轨迹。例如，若下载7天的轨迹，则需创建7个任务
  
−
===请求URI===
 
−
http://yingyan.baidu.com/api/v3/export/createjob
 
  
−
===HTTP请求方式===
+
3. 每个service_id同时只允许存在10个未完成任务，超过10个则返回创建失败，请等待现有的任务处理完之后再创建新的任务</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/export/createjob  //POST请求
−
POST
+
</pre>
−
===请求参数===
+
</div></div><div class="separate-title">请求参数</div>
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
−
!width="100"| 参数名
+
|-
−
!width="150"| 参数含义
+
! width="100" | 参数名
−
!width="80"| 类型
+
! width="150" | 参数含义
−
!width="80"| 是否必填
+
! width="80" | 类型
−
!width="250"| 备注
+
! width="80" | 是否必填
 +
! width="250" | 备注
 
|-
 
|-
 
| ak
 
| ak
−
| 用户的ak
+
| 用户的'''AK'''
 
| string
 
| string
 
| 是
 
| 是
−
|
+
|  
 
|-
 
|-
 
| service_id
 
| service_id
第90行： 第72行：
 
| int
 
| int
 
| 是
 
| 是
−
| <br>在轨迹管理台创建鹰眼服务时，系统返回的 service_id
+
| <br/>在轨迹管理台创建鹰眼服务时，系统返回的 service_id
−
<br>
+
 
 +
 
 
|-
 
|-
 
| start_time
 
| start_time
第100行： 第83行：
 
|-
 
|-
 
| end_time
 
| end_time
−
| 轨迹结束时间（不能超过当前时间）
+
| 轨迹结束时间
 
| UNIX 时间戳
 
| UNIX 时间戳
 
| 是
 
| 是
−
| 起始时间和结束时间差在24小时之内。
+
| 注：结束时间需比当前最新时间小12小时（即只能下载12小时以前的轨迹），且结束时间和起始时间差在24小时之内（即一次只能下载24小时区间内的轨迹）。
 
|-
 
|-
 
| coord_type_output
 
| coord_type_output
第110行： 第93行：
 
| 否
 
| 否
 
| 默认值：bd09ll
 
| 默认值：bd09ll
−
该字段用于控制返回结果中的坐标类型。可选值为：
+
该字段用于控制返回结果中的坐标类型。可选值为： gcj02：国测局加密坐标 bd09ll：百度经纬度坐标 该参数仅对国内（包含港、澳、台）轨迹有效，海外区域轨迹均返回 wgs84坐标
−
gcj02：国测局加密坐标
+
 
−
bd09ll：百度经纬度坐标
+
|-
−
该参数仅对国内（包含港、澳、台）轨迹有效，海外区域轨迹均返回 wgs84坐标
+
| sn
 +
| 用户的权限签名，'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
 +
| string
 +
| 否
 +
|
 
|}
 
|}
−
 
+
<div class="separate-title">返回参数</div>
−
===返回参数===
+
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
−
!width="100"| 参数名
+
|-
−
!width="150"| 参数含义
+
! width="100" | 参数名
−
!width="80"| 类型
+
! width="150" | 参数含义
−
!width="350"| 备注
+
! width="80" | 类型
 +
! width="350" | 备注
 
|-
 
|-
 
| status
 
| status
第138行： 第125行：
 
| 任务id，每个任务的唯一标识
 
| 任务id，每个任务的唯一标识
 
|}
 
|}
−
 
+
<div class="separate-title">请求示例</div><div class="serve-explain-text">
−
===请求示例===
+
 
以下载2016年8月7日的轨迹数据为例：
 
以下载2016年8月7日的轨迹数据为例：
−
http://wiki.lbsyun.baidu.com/cms/yingyan/exportcreatejob.png
+
https://lbsyun.baidu.com/cms/yingyan/exportcreatejob.png</div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">{
−
 
+
−
===返回示例===
+
−
 
+
−
{| border="1" cellspacing="0" cellpadding="0"
+
−
!width="900"| JSON
+
−
|-
+
−
| {
+
−
 
+
 
     "status": 0,
 
     "status": 0,
 
     "message": "成功"
 
     "message": "成功"
−
     "job_id" : 1
+
     "job_id"&nbsp;: 1
−
}
+
−
|}
+
  
−
==deletejob——  删除任务==
+
}</pre>
−
===接口说明===
+
−
根据job_id删除任务
+
−
===请求URI===
+
−
http://yingyan.baidu.com/api/v3/export/deletejob
+
  
−
===HTTP请求方式===
+
 
−
POST
+
<div class="separate-title service-page-anchor">deletejob——删除任务</div><div class="serve-explain-text">根据job_id删除任务</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/export/deletejob    //POST 请求
−
===请求参数===
+
</pre>
 +
</div></div><div class="separate-title">请求参数</div>
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
−
!width="100"| 参数名
+
|-
−
!width="150"| 参数含义
+
! width="100" | 参数名
−
!width="80"| 类型
+
! width="150" | 参数含义
−
!width="80"| 是否必填
+
! width="80" | 类型
−
!width="250"| 备注
+
! width="80" | 是否必填
 +
! width="250" | 备注
 
|-
 
|-
 
| ak
 
| ak
−
| 用户的ak
+
| 用户的'''AK'''
 
| string
 
| string
 
| 是
 
| 是
−
|
+
|  
 
|-
 
|-
 
| service_id
 
| service_id
第182行： 第156行：
 
| int
 
| int
 
| 是
 
| 是
−
| <br>在轨迹管理台创建鹰眼服务时，系统返回的 service_id
+
| <br/>在轨迹管理台创建鹰眼服务时，系统返回的 service_id
−
<br>
+
 
|-
 
|-
 
| job_id
 
| job_id
第190行： 第163行：
 
| 是
 
| 是
 
| 每个任务的唯一标识
 
| 每个任务的唯一标识
 +
|-
 +
| sn
 +
| 用户的权限签名，'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
 +
| string
 +
| 否
 +
|
 
|}
 
|}
−
 
+
<div class="separate-title">返回参数</div>
−
===返回参数===
+
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
−
!width="100"| 参数名
+
|-
−
!width="150"| 参数含义
+
! width="100" | 参数名
−
!width="80"| 类型
+
! width="150" | 参数含义
−
!width="350"| 备注
+
! width="80" | 类型
 +
! width="350" | 备注
 
|-
 
|-
 
| status
 
| status
第209行： 第188行：
 
| 对status的中文描述
 
| 对status的中文描述
 
|}
 
|}
−
 
+
<div class="separate-title">请求示例</div><div class="serve-explain-text">https://lbsyun.baidu.com/cms/yingyan/exportdeletejob.png</div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">{
−
===请求示例===
+
−
http://wiki.lbsyun.baidu.com/cms/yingyan/exportdeletejob.png
+
−
 
+
−
===返回示例===
+
−
 
+
−
{| border="1" cellspacing="0" cellpadding="0"
+
−
!width="1000"| JSON
+
−
|-
+
−
| {
+
  
 
     "status": 0,
 
     "status": 0,
 
     "message": "成功"
 
     "message": "成功"
 
}
 
}
−
|}
+
</pre>
  
−
|}
 
  
−
==getjob——查询任务==
+
<div class="separate-title service-page-anchor">getjob——查询任务</div><div class="serve-explain-text">
−
===接口说明===
+
 
查询任务池中的任务，任务池中包括以下几类任务：
 
查询任务池中的任务，任务池中包括以下几类任务：
  
第238行： 第206行：
  
  
−
已完成的任务会返回file_url，将地址粘贴至浏览器或使用其他下载方法，即可获得轨迹数据文件。
+
已完成的任务会返回file_url，将地址粘贴至浏览器或使用其他下载方法，即可获得轨迹数据文件。</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/export/getjob     //GET 请求
−
 
+
</pre>
−
===请求URI===
+
</div></div><div class="separate-title">请求参数</div>
−
http://yingyan.baidu.com/api/v3/export/getjob
+
−
 
+
−
===HTTP请求方式===
+
−
GET
+
−
===请求参数===
+
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
−
!width="100"| 参数名
+
|-
−
!width="150"| 参数含义
+
! width="100" | 参数名
−
!width="80"| 类型
+
! width="150" | 参数含义
−
!width="80"| 是否必填
+
! width="80" | 类型
−
!width="250"| 备注
+
! width="80" | 是否必填
 +
! width="250" | 备注
 
|-
 
|-
 
| ak
 
| ak
−
| 用户的ak
+
| 用户的'''AK'''
 
| string
 
| string
 
| 是
 
| 是
−
|
+
|  
 
|-
 
|-
 
| service_id
 
| service_id
第263行： 第227行：
 
| int
 
| int
 
| 是
 
| 是
−
|在轨迹管理台创建鹰眼服务时，系统返回的 service_id
+
| 在轨迹管理台创建鹰眼服务时，系统返回的 service_id
 
|}
 
|}
−
 
+
<div class="separate-title">返回参数</div>
−
===返回参数===
+
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
−
!width="100" colspan="2"|参数名
 
−
!width="150"| 参数含义
 
−
!width="80"| 类型
 
−
!width="350"| 备注
 
 
|-
 
|-
−
| colspan="2"|status
+
! width="100" colspan="2" | 参数名
 +
! width="150" | 参数含义
 +
! width="80" | 类型
 +
! width="350" | 备注
 +
|-
 +
| colspan="2" | status
 
| 状态码
 
| 状态码
 
| int
 
| int
 
| 返回状态，0为成功
 
| 返回状态，0为成功
 
|-
 
|-
−
| colspan="2"|message
+
| colspan="2" | message
 
| 响应信息
 
| 响应信息
 
| string
 
| string
 
| 对status的中文描述
 
| 对status的中文描述
 
|-
 
|-
−
| colspan="2"|total
+
| colspan="2" | total
 
| 任务总条数
 
| 任务总条数
 
| int
 
| int
 
| 当前service_id下的任务总数
 
| 当前service_id下的任务总数
 
|-
 
|-
−
| colspan="2"|jobs
+
| colspan="2" | jobs
−
| 任务总条数
+
| 任务
−
| int
+
| <br/>
−
| 当前service_id下的任务总数
+
| <br/>
 
|-
 
|-
−
|
+
|  
 
| job_id
 
| job_id
 
| 任务id
 
| 任务id
第299行： 第263行：
 
|  
 
|  
 
|-
 
|-
−
|
+
|  
 
| start_time
 
| start_time
 
| 轨迹起始时间
 
| 轨迹起始时间
第305行： 第269行：
 
|  
 
|  
 
|-
 
|-
−
|
+
|  
 
| end_time
 
| end_time
 
| 轨迹结束时间
 
| 轨迹结束时间
第311行： 第275行：
 
|  
 
|  
 
|-
 
|-
−
|
+
|  
 
| coord_type_output
 
| coord_type_output
 
| 返回的坐标类型
 
| 返回的坐标类型
 
|  
 
|  
 
| 返回值的坐标类型。可能返回的值为：
 
| 返回值的坐标类型。可能返回的值为：
−
gcj02：国测局加密坐标
+
gcj02：国测局加密坐标 bd09ll：百度经纬度坐标 该参数仅对国内（包含港、澳、台）轨迹有效，海外区域轨迹均返回 wgs84坐标
−
bd09ll：百度经纬度坐标
+
 
−
该参数仅对国内（包含港、澳、台）轨迹有效，海外区域轨迹均返回 wgs84坐标
+
 
|-
 
|-
−
|
+
|  
−
| create_time
+
| create_time
−
| 任务创建的格式化时间
+
| 任务创建的格式化时间
−
| string
+
| string
 
| 该时间为服务端时间
 
| 该时间为服务端时间
 
|-
 
|-
−
|
+
|  
−
| create_time
+
| modify_time
−
| 任务创建的格式化时间
+
| 任务创建的格式化时间
−
| string
+
| string
 
| 该时间为服务端时间
 
| 该时间为服务端时间
 
|-
 
|-
−
|
+
|  
−
| modify_time
+
| job_status
−
| 任务创建的格式化时间
+
| 任务当前的执行状态
−
| string
+
| string
−
| 该时间为服务端时间
+
| 取值范围：
 +
waiting：待处理 running：正在准备数据 done：数据已准备完成，已生成可供下载的数据文件
 +
 
 
|-
 
|-
−
|
+
|  
−
| job_status
+
| file_url
−
| 任务当前的执行状态
+
| 轨迹数据文件下载链接
−
| string
+
| string
−
| 取值范围：
+
| 数据准备好后（即：job_status为 done 时），将会生成轨迹数据文件下载链接，开发者可通过该链接下载数据文件。注：已完成的任务会在48小时之后自动清理，请及时下载。
−
waiting：待处理
+
−
running：正在准备数据
+
−
done：数据已准备完成，已生成可供下载的数据文件
+
 
|-
 
|-
−
|
+
| sn
−
| file_url
+
| 用户的权限签名，'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
−
| 轨迹数据文件下载链接
+
| string
−
| string
+
| 否
−
| 数据准备好后（即：job_status为 done 时），将会生成轨迹数据文件下载链接，开发者可通过该链接下载数据文件。注：已完成的任务会在48小时之后自动清理，请及时下载。
+
|  
 
|}
 
|}
−
 
+
<div class="separate-title">导出文件说明</div><div class="serve-explain-text">
−
===导出文件说明===
+
−
 
+
 
1. 导出文件名为格式为：{service_id}_{job_id}.zip（例如：135252_10.zip）
 
1. 导出文件名为格式为：{service_id}_{job_id}.zip（例如：135252_10.zip）
−
 
  
 
2. 使用zip解压工具解压可以得到文件：{service_id}_{job_id}.json（例：135252_10.json）
 
2. 使用zip解压工具解压可以得到文件：{service_id}_{job_id}.json（例：135252_10.json）
−
 
  
 
3. 文件中每行文本代表一条轨迹数据，json格式，其中：
 
3. 文件中每行文本代表一条轨迹数据，json格式，其中：
  
 
- entity_name是entiy的唯一标识，字符串类型；entity_id是鹰眼内部使用的id，可以忽略
 
- entity_name是entiy的唯一标识，字符串类型；entity_id是鹰眼内部使用的id，可以忽略
−
 
  
 
- 速度、方向、自定义字段等都存放在custom_data结构中，value统一是字符串类型
 
- 速度、方向、自定义字段等都存放在custom_data结构中，value统一是字符串类型
−
 
  
 
- coord_type是坐标类型字段，分为3种：COORD_TYPE_WGS84LL（GPS经纬度）、COORD_TYPE_GCJ02LL（国测局经纬度）、COORD_TYPE_BD09LL（百度加密经纬度）
 
- coord_type是坐标类型字段，分为3种：COORD_TYPE_WGS84LL（GPS经纬度）、COORD_TYPE_GCJ02LL（国测局经纬度）、COORD_TYPE_BD09LL（百度加密经纬度）
  
  
−
- 轨迹数据是乱序的，同一个entity的轨迹数据需要按loc_time字段排序后使用
+
- 轨迹数据是乱序的，同一个entity的轨迹数据需要按loc_time字段排序后使用</div><div class="separate-title">请求示例</div><div class="serve-explain-text">https://lbsyun.baidu.com/cms/yingyan/export.png</div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">{
−
===请求示例===
+
−
http://wiki.lbsyun.baidu.com/cms/yingyan/export.png
+
−
 
+
−
===返回示例===
+
−
 
+
−
{| border="1" cellspacing="0" cellpadding="0"
+
−
!width="1000"| JSON
+
−
|-
+
−
| {
+
 
     "status": 0,
 
     "status": 0,
 
     "message": "成功",
 
     "message": "成功",
第396行： 第343行：
 
             "modify_time": "20170807182741",
 
             "modify_time": "20170807182741",
 
             "job_status": "done",
 
             "job_status": "done",
−
             "file_url": " http://下载地址"
+
             "file_url": " [http://下载地址 http://下载地址]"
 
         },
 
         },
 
         {
 
         {
第407行： 第354行：
 
             "modify_time": "20170807182741",
 
             "modify_time": "20170807182741",
 
             "job_status": "done",
 
             "job_status": "done",
−
             "file_url": "http://下载地址"
+
             "file_url": "[http://下载地址 http://下载地址]"
 
         }
 
         }
 
     ]
 
     ]
 +
 
}
 
}
−
|}
+
</pre>
−
 
+
<div class="separate-title">导出文件示例</div><div class="serve-explain-text">https://lbsyun.baidu.com/cms/yingyan/exportfile.png</div>
−
===导出文件示例===
+
−
http://wiki.lbsyun.baidu.com/cms/yingyan/file.png
+

2022年7月22日 (五) 20:44的最后版本

简介
批量导出类接口提供批量导出轨迹数据功能，该类接口将一段时间内的轨迹数据打包成文件，生成下载链接供开发者下载。该类接口包括三个 API：
模块 接口名称 功能说明
export createjob 创建一个任务，该任务完成后将返回文件下载地址，供开发者下载
deletejob 删除任务
getjob 查询任务，将返回任务状态和文件下载地址
使用方法

该类接口使用方法为：

第一步：使用 createjob接口创建任务，获得任务 id

第二步：使用 getjob 接口定期查询任务状态，一旦返回值中的 job_status 字段为"done"时，取出 file_url 字段中的下载链接，开发者可使用自己熟悉的下载工具从该链接下载轨迹文件。

注意事项：

1. 每一次请求最多下载一天内的轨迹。例如：若需下载最近7天的轨迹，则需创建7个任务，生成7个数据文件下载


2.下载文件生成成功后，开发者需尽快下载文件，鹰眼将在48小时后删除服务端的文件
坐标系说明

目前中国主要有以下三种坐标系：

WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系

GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系

BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标

非中国地区地图，统一使用WGS84坐标

鹰眼 Web服务API v3.0的默认输入输出坐标为百度经纬度坐标系（bd09ll），同时可通过"coord_type"

，"coord_type_input"，"coord_type_output"（以各服务参数介绍为准）控制输入输出的坐标类型，鹰眼将自动完成转换。
接口说明
createjob—— 创建任务

创建一个新的轨迹数据导出任务，下载该service 内一段时间内的全部轨迹。

注意：

1. 只能下载距当前时间6小时之前的轨迹，例如：2017-8-7 10:00创建的下载任务只能下载2017-8-7 4:00之前产生的轨迹

2. 每一个任务最多下载24小时时长的轨迹。例如，若下载7天的轨迹，则需创建7个任务


3. 每个service_id同时只允许存在10个未完成任务，超过10个则返回创建失败，请等待现有的任务处理完之后再创建新的任务
请求URI
https://yingyan.baidu.com/api/v3/export/createjob   //POST请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK string 是
service_id service的ID，service 的唯一标识。 int 是
在轨迹管理台创建鹰眼服务时，系统返回的 service_id


start_time 轨迹起始时间 UNIX 时间戳 是
end_time 轨迹结束时间 UNIX 时间戳 是 注：结束时间需比当前最新时间小12小时（即只能下载12小时以前的轨迹），且结束时间和起始时间差在24小时之内（即一次只能下载24小时区间内的轨迹）。
coord_type_output 返回的坐标类型 string 否 默认值：bd09ll

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

sn 用户的权限签名，若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则 		string 否
返回参数
参数名 参数含义 类型 备注
status 状态码 int 返回状态，0为成功
message 响应信息 string 对status的中文描述
job_id 任务 id int 任务id，每个任务的唯一标识
请求示例

以下载2016年8月7日的轨迹数据为例：

exportcreatejob.png
返回示例
{
    "status": 0,
    "message": "成功"
    "job_id" : 1

}


deletejob——删除任务
根据job_id删除任务
请求URI
https://yingyan.baidu.com/api/v3/export/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的中文描述
请求示例
exportdeletejob.png
返回示例
{

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


getjob——查询任务

查询任务池中的任务，任务池中包括以下几类任务：

1. 已创建尚未开始执行的任务

2. 正在执行的任务

3. 已完成的任务，但完成时间不超过48小时（注：已完成的任务会在48小时之后自动清理）


已完成的任务会返回file_url，将地址粘贴至浏览器或使用其他下载方法，即可获得轨迹数据文件。
请求URI
https://yingyan.baidu.com/api/v3/export/getjob     //GET 请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK string 是
service_id service的ID，service 的唯一标识。 int 是 在轨迹管理台创建鹰眼服务时，系统返回的 service_id
返回参数
参数名 参数含义 类型 备注
status 状态码 int 返回状态，0为成功
message 响应信息 string 对status的中文描述
total 任务总条数 int 当前service_id下的任务总数
jobs 任务

job_id 任务id int
start_time 轨迹起始时间 UNIX 时间戳
end_time 轨迹结束时间 UNIX 时间戳
coord_type_output 返回的坐标类型 返回值的坐标类型。可能返回的值为：

gcj02：国测局加密坐标 bd09ll：百度经纬度坐标 该参数仅对国内（包含港、澳、台）轨迹有效，海外区域轨迹均返回 wgs84坐标

create_time 任务创建的格式化时间 string 该时间为服务端时间
modify_time 任务创建的格式化时间 string 该时间为服务端时间
job_status 任务当前的执行状态 string 取值范围：

waiting：待处理 running：正在准备数据 done：数据已准备完成，已生成可供下载的数据文件

file_url 轨迹数据文件下载链接 string 数据准备好后（即：job_status为 done 时），将会生成轨迹数据文件下载链接，开发者可通过该链接下载数据文件。注：已完成的任务会在48小时之后自动清理，请及时下载。
sn 用户的权限签名，若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则 		string 否
导出文件说明

1. 导出文件名为格式为：{service_id}_{job_id}.zip（例如：135252_10.zip）

2. 使用zip解压工具解压可以得到文件：{service_id}_{job_id}.json（例：135252_10.json）

3. 文件中每行文本代表一条轨迹数据，json格式，其中：

- entity_name是entiy的唯一标识，字符串类型；entity_id是鹰眼内部使用的id，可以忽略

- 速度、方向、自定义字段等都存放在custom_data结构中，value统一是字符串类型

- coord_type是坐标类型字段，分为3种：COORD_TYPE_WGS84LL（GPS经纬度）、COORD_TYPE_GCJ02LL（国测局经纬度）、COORD_TYPE_BD09LL（百度加密经纬度）


- 轨迹数据是乱序的，同一个entity的轨迹数据需要按loc_time字段排序后使用
请求示例
export.png
返回示例
{
    "status": 0,
    "message": "成功",
    "total": 2,
    "jobs": [
        {
            "job_id": 1239,
            "service_id": 142322,
            "start_time": 1470499200,
            "end_time": 1470585599,
            "coord_type_output": "bd09ll",
            "create_time": "20170807182734",
            "modify_time": "20170807182741",
            "job_status": "done",
            "file_url": " [http://下载地址 http://下载地址]"
        },
        {
            "job_id": 1238,
            "service_id": 142322,
            "start_time": 1470499200,
            "end_time": 1470585599,
            "coord_type_output": "bd09ll",
            "create_time": "20170807182733",
            "modify_time": "20170807182741",
            "job_status": "done",
            "file_url": "[http://下载地址 http://下载地址]"
        }
    ]

}
导出文件示例
exportfile.png
取自“http://lbsyun.baidu.com/index.php?title=yingyan/api/v3/trackexport&oldid=17531”

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消