> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.
# モバイル測位データの照会
> データソースの「測位データ（モバイル）」で、モバイル SDK が収集した測位座標とゾーンイベントの状況を確認し、元データを照会します。
「測位データ（モバイル）」は、モバイル SDK が収集した位置の元データです。データソースで収集状況を確認し、測位座標とゾーンの進入・退出イベントを照会またはダウンロードできます。
## 1) データソースを開く
OneS1ght コンソールには [`console.ones1ght.com`](https://console.ones1ght.com) からアクセスします。
データソースのメニューは、**管理者（manager）以上**の権限がないと表示されません。アカウントがない場合や権限が足りない場合は、
組織の最高管理者（owner）または管理者（manager）に招待と権限を依頼してください。OneS1ght は招待制のため、セルフ会員登録はできません。
1. OneS1ght コンソールにログインした後、サイドバーから \[データソース] に移動します。
2. 「測位データ（モバイル）」カードの \[開く] をクリックします。モバイル SDK が収集した位置の元データで、読み取り専用です。
## 2) データ状況の確認
データ状況に、これまでに収集された件数が表示されます。
| 項目 | 説明 |
| - | - |
| 測位座標 | ·モバイル SDK が収集した座標の件数·クリックすると元データの照会画面に移動 |
| ゾーンイベント | ·ゾーンの進入・退出イベントの件数 |
| 利用者（機器） | ·機器単位の匿名識別子を基準とした利用者数·会員情報とは紐付けられない |
| 登録機器 | ·登録された機器の数 |
* データ状況の右上の状態表示は、直近 24 時間以内に収集された座標があれば **Active**、なければ **待機** と表示されます。
* 測位座標とゾーンイベントは、90 日が経過すると自動的に削除されます。
検証アプリで測位を行った直後にこの画面を開くと、状態が **Active** で、測位座標の件数が検証前より増えているはずです。
状態が「待機」のままか、件数が増えない場合は、座標がサーバーに届いていないため、
[onesight-support@onecheck.co.kr](mailto:onesight-support@onecheck.co.kr) までお問い合わせください。
## 3) 元データの照会
データ状況画面の右上の \[データ照会] (③) をクリックすると、「モバイル（SDK）元データ」画面が開きます。
1. 照会対象を選択します。「測位」は収集された座標、「イベント」はゾーンの進入・退出の記録です。
2. 開始・終了時刻を指定するか、期間ボタン（1分 ～ 30日）をクリックした後、\[照会] をクリックします。今日を基準に直近 3 か月まで照会できます。
3. 必要に応じて、建物、フロア、実行環境、実行キー、キーワード（訪問者 ID・匿名 ID の先頭部分）で範囲を絞り込みます。「イベント」ではゾーンでも絞り込めます。
**照会対象が「測位」の場合**
| 列 | 説明 |
| - | - |
| captured\_at | ·収集時刻。表では基準タイムゾーンで表示され、ダウンロードするファイルは UTC のまま |
| key\_name · environment | ·座標を送信した SDK キーの名前と環境 |
| floor\_id | ·フロア ID |
| x · y · z | ·測位座標（m）。基準点からの幅・奥行きの距離と高さ |
| platform | ·iOS または Android |
**照会対象が「イベント」の場合**
| 列 | 説明 |
| - | - |
| occurred\_at | ·イベントの発生時刻 |
| key\_name · environment | ·イベントを送信した SDK キーの名前と環境 |
| floor\_id · zone\_id · zone\_name | ·イベントが発生したフロアとゾーン |
| status | ·IN: ゾーンに進入·OUT: ゾーンから退出 |
| profile\_id · visitor\_id | ·機器単位の匿名識別子。会員情報とは紐付けられない |
| platform | ·iOS または Android |
* 行をクリックすると、右側にその1件の詳細が開きます。
* \[CSV]・\[TXT]・\[JSON] で照会結果をダウンロードできます。
アーカイブの案内が表示される区間（移行時点より前の行）は S3 アーカイブから読み込むため、初回の照会に数秒かかることがあります。
## チェックリスト
測位インフラを構築した後、動作検証と合わせて確認します。
| # | 確認項目 | 確認 |
| - | - | :-: |
| 1 | 「測位データ（モバイル）」のデータ状況の状態が Active で、測位座標の件数が検証後に増えました。 | ☐ |
| 2 | 元データの照会で、検証した時間帯の座標の行が照会されます。 | ☐ |
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.