全部服务产品
开发者频道
定价
登录
权限和配额
下载开发文档
权限说明

鹰眼开发者的使用权限包括:

1. 数据存储:开发者可向自己的鹰眼服务中上传轨迹数据。鹰眼将为开发者存储最近1年的轨迹数据,若需保留1年之外的轨迹数据,开发者可通过轨迹查询或轨迹批量导出接口将数据下载到自己的服务器中备份,或可通过反馈平台联系我们,申请延长存储期限。

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

配额说明

开放平台的每一类 API 都有调用配额限制,配额为帐号下所有ak和service共用。鹰眼针对不同类型的开发者设定了默认配额,如下表所示。

overview_quota2020.png
配额计算方法

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

通过 API 调用一次track/gettrack,算作一次请求
通过 API 调用一次track/addpoints,上传了200个轨迹点,算作200次请求
通过 SDK 调用一次方法startService算作一次请求,方法上传1000个轨迹点算作1000次请求(注:该配额计算策略从V3.1.0版本及以后版本生效,历史版本上传轨迹点不计算配额)
通过 SDK 的 queryentitylist()方法,查询entity 实时位置,算作一次请求

鹰眼API配额分为"PV(请求次数/日)"和"QPS(请求次数/秒)"两类:

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

鹰眼接口分组如下:

轨迹查询:含轨迹查询、里程查询等3个接口:track/getlatestpoint,track/getdistance,track/gettrack
轨迹分析:含停留点分析和驾驶行为分析2个接口:analysis/staypoint,analysis/drivingbehavior
object(图像):SDK中图像数据上传和查询类接口(鹰眼iOS SDK暂不支持object相关功能)
SDK轨迹上传:通过鹰眼Android和iOS SDK上传轨迹的并发(一个轨迹点算一次并发,计算的是小时级并发,即:1小时内请求的PV/3600)
其他:除以上三组类接口以外的接口,如:轨迹上传(track/addpoint,track/addpoints)、地理围栏、entity增删改查等
配额计算示例

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

示例:某开发者利用鹰眼管理一个车队,该车队每日活跃车辆数为10,000辆,车辆每30s定位一次,每10分钟查询一次轨迹,车辆平均每天在线12小时,配额计算如下:

上传轨迹并发:1,000 车辆 * 6次/分钟 = 6,000次/分钟 = 100次/秒

查询轨迹并发:1,000 车辆 * 1次/分钟=1,000 次/分钟 = 17次/秒

日pv:(100 + 17)次/秒 * 3600秒 * 12 小时 = 505.44万次

其他接口以此类推。

服务使用限制

服务相关配额及并发请求限制请访问开发者权益页面查看。

上一篇

鹰眼基本概念

下一篇

配置工程

本篇文章对您是否有帮助?