权限和配额

使用权限

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


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


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

鹰眼配额限制

为防止配额滥用,鹰眼针对不同类型的开发者设定了默认配额,如下表所示。

quota.png


开发者若需要更高配额,可在开发者认证后,进入API控制台->我的服务自行申请配额,工作人员将在1-3个工作日内审批。

只要是开发者合理的配额需求,我们都将尽力支持。

申请配额的方法

申请配额时,如下图所示,开发者可申请"请求量" 和"并发量"两类配额:

%E9%85%8D%E9%A2%9D.png

【请求量】:即每日请求鹰眼服务的总次数


【并发量】:即每分钟请求峰值。鹰眼对并发配额进行了分组,开发者可分别申请组别的鹰眼 API的并发配额。鹰眼 API 分组如下:

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

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

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

鹰眼配额的计算方法

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


鹰眼计算开发者的调用量的规则为:通过鹰眼 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 实时位置,算作一次请求。

鹰眼配额的计算方式

通过鹰眼 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 实时位置,算作一次请求。