权限和配额

使用权限

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


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


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

鹰眼配额限制

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


配额分为两类:

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. 每组接口的调用频率


applyquota1.png

鹰眼配额的计算方法

开发者可根据活跃 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 实时位置,算作一次请求。