Table of Contents

Qps 予測とスケールアウト

同時リクエスト数は QPS（Queries per second）で計測され、サーバーが1秒間に受信する有効なサービスリクエスト数を指します。位置特定が成功したかどうかに関わらず、リクエストに正しいクラウド位置特定ライブラリの AppId が含まれ認証を通過した場合、同時リクエスト数としてカウントされます。

デバイスは初期化成功後、デフォルトで毎秒1回の頻度で位置特定リクエストを送信します。ネットワーク遅延やリクエスト到達時間のばらつきにより、瞬間的な同時リクエスト数が QPS 制限を超える場合があります。例えば、10 QPS は理論上10台のデバイスをサポートできますが、1秒間に10を超えるリクエストを受信した場合、超過分は拒否されます。マルチデバイス同時接続シナリオでのサービス安定性を確保するため、QPS 購入時に一定の余裕（例：10台対応時に 11–12 QPS）を設定することを推奨します。

クラウド位置特定サービスグループはデフォルトで10同時リクエスト数を提供し、ほとんどのアプリケーションシナリオのニーズを満たします。より高い同時接続が必要な使用ケース向けに、柔軟なリソース拡張ソリューションを提供しています：

  • 休日などの高負荷期間には、短期拡張パッケージで一時的に同時接続能力を向上可能
  • ユーザー数が多く安定した高同時接続サポートが必要なアプリケーション向けに、追加同時リソースをサービスグループ有効期間中に長期紐付け可能

10 QPS をベースに、短期追加パッケージまたは長期固定同時クォータ増加を柔軟に選択でき、ビジネスフェーズに応じたリソースニーズに対応できます。

同時リクエスト数超過時の挙動

割り当てられた QPS を瞬間的に超過した場合、サービスは以下のエラー情報を返します（例）：

statuCode： 21, message: "Exceed your QPS limitation"

トライアルユーザーが位置特定できない場合、QPS 不足が原因の可能性があります。Mega Toolbox でログを開き応答メッセージを確認することを推奨します。下図参照:

qps-limit

注記

トライアルユーザーの同時リクエスト数クォータは小規模です。位置特定失敗時は超過エラー情報の有無を重点的に確認してください。

同時リクエスト数 Qps スケールアウト

同時接続クォータ拡大には2つの方法があります:

  • 営業またはカスタマーサポートへの直接相談（大規模・長期・カスタマイズ要件向け）
  • 管理コンソールからのオンライン直接アップグレード（一時的・小規模拡張向け）

営業経由でのアップグレード

日常的な同時リクエスト数が 50 QPS を超えると予想される場合、EasyAR 営業またはサポートに連絡しキャパシティ拡張とリソース保証を手配してください。拡張後は開発者ポータルにログインしクォータが有効化されたか確認してください。

同時リクエスト数クォータ確認の操作手順は、下図枠内の通りです:

操作ステップ:

  • 開発センター -> Block クラウド位置特定 -> クラウド位置特定サービスグループ -> 現在の QPS

check-qps

アップグレード後の QPS 数量と有効期限の確認を推奨します。EasyAR 管理画面での確認方法は次節で説明します: 同時リクエスト数 Qps 管理

オンラインアップグレード

コンソールには2箇所の QPS オンラインアップグレード用エントリがあります。下図参照:

  1. 開発センター -> Block クラウド位置特定 -> クラウド位置特定サービスグループ -> アップグレード

  2. 開発センター -> Block クラウド位置特定 -> クラウド位置特定サービスグループ -> QPS 詳細 -> アップグレード

add-qps

重要

50 QPS 以上の大規模同時接続要件については、リソース供給安定性確保のため営業相談が必要です。

同時リクエスト数 Qps 管理

同時リクエスト数管理の主な内容:

  • 現在の QPS 数量の確認
  • QPS 拡張
  • 一部 QPS の有効期限延長

管理画面

操作ステップ

  • 開発センターにログイン -> Block クラウド位置特定 -> クラウド位置特定サービスグループ -> QPS 詳細

Qps 数量と有効期限のアップグレード

qps-manage

    QPS 詳細画面は上図の通りです。現在の QPS 数量は右側の枠でマークされています。

    画面中央のタイムラインは、基本 QPS 部分とアップグレード QPS 部分の有効期間を表示します。

    最下部の購入記録には、アップグレード注文と有効期限の詳細が表示されます。

推奨事項

  • 平均値ではなく予想ピーク同時接続数を推定し、ピーク用に余裕を持たせてください（例：ピーク 10 QPS なら 11–12 QPS 購入推奨）。
  • 休日やイベント期間中は、一時的な短期追加パッケージで高同時接続ニーズに対応可能です。
  • 拡張後検証: Mega Toolbox を使用し高負荷環境でリクエスト拒否なし・安定した応答を確認してください。
  • 持続的な拒否や異常が発生した場合、ログを収集しサポートチームに調査依頼してください（時間枠・クラウド位置特定ライブラリの AppId・可能であればリクエストサンプルとエラーコードを含むキャプチャファイルを提供）。

次のトピックを読む

その他の Mega サービス拡張とクォータ説明