QPS 预估与扩容
并发数采用 QPS（Queries per second）进行计量，即服务器每秒接收到的有效服务请求数。无论定位是否成功，只要请求中携带了正确的云定位库 AppId 且通过认证，即会计入并发统计。
设备在初始化成功后，默认会以每秒 1 次的频率发送定位请求。由于网络延迟和请求到达时间存在差异，可能出现瞬时并发超过 QPS 限制的情况。例如，10 QPS 理论上可支持 10 台设备，但若在同一秒内收到超过 10 个请求，超出的请求将被拒绝。为确保多设备并发场景下的服务稳定性，建议您在购买 QPS 时预留一定冗余，例如支持 10 台设备时，可配置 11–12 QPS。
云定位服务组默认提供 10 个并发，可满足大部分应用场景的需求。针对更高并发的使用场景，我们也提供了灵活的资源扩展方案：
- 节假日等高并发时段，可选择短期扩容包临时提升并发能力
- 对于用户量较大、需稳定高并发支持的应用，支持将额外并发资源长期绑定至云服务组有效期内
在 10 QPS 的基础上，您可灵活选择短期补充包，或长期增加固定并发配额，以适应不同业务阶段的资源需求。
并发超限时的表现
当请求瞬时超过分配的 QPS，服务会返回如下错误信息（示例）：
statuCode： 21, message: "Exceed your QPS limitation"
试用状态的用户定位不到，很可能由于 QPS 不足，建议您通过 Mega Toolbox 打开日志查看响应消息。如图所示：
注意
试用用户并发配额比较小，定位不到的时候，建议多关注是否有超限的错误信息。
并发 QPS 扩容
您可以通过两种途径扩大并发配额：
- 线下咨询商务或客服（适用于大规模、长期或定制化需求）
- 在线在管理控制台直接升级（适用于临时或小幅扩容）
线下咨询商务升级
当预期日常并发超过 50 QPS，建议联系 EasyAR 销售或客服安排容量扩展与资源保障。扩容后请登录开发者后台确认额度是否生效。
确认并发额度的操作过程，如下图框所示：
操作步骤：
- 开发中心 -> Block 云定位 -> 云定位服务组 -> 当前 QPS
建议确认升级后 QPS 数量和使用有效期。通过 EasyAR 管理界面查看，下一节有操作介绍： 并发 QPS 管理
在线升级
控制台有两处入口支持在线升级 QPS，如下图所示：
开发中心 -> Block 云定位 -> 云定位服务组 -> 升级
开发中心 -> Block 云定位 -> 云定位服务组 -> QPS 详细 -> 升级
重要事项
对于 50 QPS 以上的大并发需求，仍需要咨询商务，以确保资源供应稳定。
管理并发 QPS
并发管理的主要包括：
- 查看 QPS 当前数量
- QPS 扩容
- 升级部分 QPS 的有效期
管理界面
操作步骤
- 登录进入开发中心 -> Block 云定位 -> 云定位服务组 -> QPS 详细
升级 QPS 数量和有效期
进入 QPS 详细，界面如上图所示。当前 QPS 数量显示在图中右侧框标记。
界面中间的时间轴显示基础 QPS 部分以及升级 QPS 部分的时间有效期。
最下面购买记录展示升级订单以及有效期的详情细节。
建议
- 估算预期峰值并发而非平均并发，为峰值预留冗余（例如峰值 10 QPS 建议购买 11–12 QPS）。
- 节假日或活动期间可临时购买短期补充包满足高并发需求。
- 扩容后验证：使用 Mega Toolbox 在高并发场景下确认请求未被拒绝且响应稳定。
- 若遇持续拒绝或异常，请收集日志并联系支持团队排查（包含时间窗口、云定位库的 AppId 、建议提供抓包文件包含请求样例与错误码）。