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