权限和配额

使用权限

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


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


数据访问:开发者创建的鹰眼服务可被该帐号下的ak访问,但不可被其他开发者访问。

鹰眼配额说明

开放平台的每一类 API 都有调用配额限制,配额是帐号下所有 ak 和 service_id共用(例如:一个帐号下鹰眼 pv 配额为10万,其创建了5个 ak,6个 service_id,则所有 ak 和 service_id 共用这10万配额)。

鹰眼相关配额如下: quota1.png


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

1. 通过 API 调用一次track/gethistory,算作一次请求

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

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

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


鹰眼请求量配额分为请求量和并发量两类:

1. 请求量

即每日请求鹰眼接口的总次数,所有鹰眼接口共享该配额。


2. 并发量

即每分钟请求鹰眼接口的次数,鹰眼按照接口类别对并发进行分组控制,开发者可根据实际业务需求,申请各类别接口的并发配额。鹰眼 API 分类如下:


轨迹查询:含轨迹查询、里程查询等3个接口:track/getlatestpoint , track/getdistance , track/gettrack


轨迹分析:含停留点分析和驾驶行为分析2个接口: analysis/staypoint , analysis/drivingbehavior


object(图像):SDK 中图像数据上传和查询类接口


其他:除以上两组接口以外的所有接口,如:轨迹上传(track/addpoint , track/addpoints)、地理围栏entity管理

申请配额提升的方法

每位开发者都会拥有自己的默认配额,但若随着业务提升对配额有更高需求,开发者可在开发者认证后,进入API控制台->我的服务自行申请配额,工作人员将在1-3个工作日内审批,不合理的配额需求将被拒绝,合理的配额需求,鹰眼将免费支持。


为提升申请通过率,请开发者详细阅读鹰眼配额计算方法,合理计算配额需求,并在申请原因中说明以下信息,以便工作人员判断配额使用合理性:

1. 日活跃终端数

2. 轨迹上传频率

3. 轨迹查询/分析接口调用频率

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


applyquota1.png

鹰眼配额的计算示例

开发者可根据活跃 entity 量、每个 entity 调用鹰眼 API 的频率(一分钟调用几次)以及时长(一天调用多少小时)估算日调用量和并发量。


示例:

若一个开发者需要管理日活1万的车辆,每辆车30s采集一个轨迹点,每辆车约10分钟查询一次轨迹,车辆平均每天在线12小时。则配额估算为:


- 上传轨迹并发:1万车辆 * 2次/分钟 = 2万

- 查询轨迹并发:1万车辆 * 0.1次/分钟=0.1万

- 日 pv:(2万 + 0.1万)* 60分钟*12小时 = 1512万


其他接口以此类推