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

鹰眼轨迹服务

百度鹰眼是一套轨迹追踪开放服务,开发者在终端集成鹰眼API/SDK 后,可同时管理并追踪数千万终端设备的轨迹,适用于车队管理、共享出行、外勤人员管理、智能穿戴等领域。

权限说明

鹰眼的基础功能目前免费提供给开发者,如果满足您的需求且不违背“百度地图API使用条款”的情况下,可以直接使用,无需商业授权。开发者的使用权限包括:

数据存储:开发者可向自己的鹰眼服务中上传轨迹数据。鹰眼将为开发者存储最近1年的轨迹数据,若需保留1年之外的轨迹数据,开发者可通过轨迹查询或轨迹批量导出接口将数据下载到自己的服务器中备份,或发送邮件至:baiduyingyan@baidu.com申请延长存储期限。

数据访问:开发者创建的鹰眼服务可被该帐号下的ak访问,除非开发者授权,否则不可被其他用户访问。开鹰眼轨迹管理台提供授权功能,支持开发者将自有 service 授权给其他开发者访问。

配额说明
开放平台的每一类 API 都有调用配额限制,配额为帐号下所有ak和service共用。鹰眼针对不同类型的开发者设定了默认配额,如下表所示。
开发者若需要更高配额,可在开发者认证后,进入API控制台->我的服务自行申请配额,工作人员将在1-3个工作日内审批。只要是合理的配额需求,我们都将尽力支持。
quota1.png
鹰眼配额的计算方法

鹰眼请求量计算方法为:通过鹰眼 Web 服务 API 或 鹰眼SDK 调用一次接口计一次配额(除 web 服务 API 的 track/addpoints外,该接口为批量接口,一个轨迹点计一次配额),例如:

通过 API 调用一次track/gettrack,算作一次请求

通过 API 调用一次track/addpoints,上传了200个轨迹点,算作200次请求

通过 SDK 调用一次 starttrace()方法,算作一次请求,但随后持续上传轨迹点不计入配额,因为未再调用接口。可以理解为,通过 sdk 的 starttrace 上传轨迹点不计入配额

通过 SDK 的 queryentitylist()方法,查询entity 实时位置,算作一次请求


鹰眼API配额分为"日请求量"和"分钟并发请求量"两类:

日请求量:即每日请求鹰眼接口的总次数,所有鹰眼接口共享该配额
分钟并发请求量:即每分钟请求鹰眼接口的次数,鹰眼接口分为几类,每类接口的并发配额不同

鹰眼 API 分类如下:
轨迹查询:含轨迹查询、里程查询等3个接口:track/getlatestpoint,track/getdistance,track/gettrack
轨迹分析:含停留点分析和驾驶行为分析2个接口:analysis/staypoint,analysis/drivingbehavior
object(图像):SDK中图像数据上传和查询类接口

其他:除以上三组类接口以外的接口,如:轨迹上传(track/addpoint,track/addpoints)、地理围栏、entity增删改查等
鹰眼配额的计算示例

开发者可根据活跃entity数、每个entity 调用鹰眼 API 的频率(一分钟调用几次)以及每日在线时长(一天调用多少小时)估算日调用量和并发量。
示例:某开发者利用鹰眼管理一个车队,该车队每日活跃车辆数为10,000辆,车辆每30s定位一次,每10分钟查询一次轨迹,车辆平均每天在线12小时,配额计算如下:
上传轨迹并发:10,000 车辆 * 2 次/分钟 = 20,000 次/分钟 查询轨迹并发:10,000 车辆 * 0.1 次/分钟=1,000 次/分钟

日pv:(2,0000 + 1,000)* 60 分钟*12小时 = 1512万次
其他接口以此类推
申请配额的方法

每位开发者都有默认配额限制,若随着业务发展对配额有更高需求,开发者可在开发者认证后,进入API控制台->我的服务自行申请配额,工作人员将在1-3个工作日内审批,不合理的配额需求将被拒绝,合理的配额需求,鹰眼将免费支持。
为提升申请通过率,请开发者详细阅读鹰眼配额计算方法,合理计算配额需求,并在申请原因中说明以下信息,以便工作人员判断配额使用合理性:

日活跃终端数
轨迹上传频率
轨迹查询/分析接口调用频率

图像上传类接口调用频率
applyquota1.png