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 、建議提供抓包文件包含請求樣例與錯誤碼）。