Geospatial API は、VPS データと GPS データの組み合わせを使用して、高精度の Geospatial 変換を生成します。この API は、デバイスが現在地を特定できる場所であればどこでも使用できます。
- 屋内空間や密集した都市環境など、GPS の精度が低い地域では、API は VPS カバレッジを利用して高精度の変換を生成します。
- 頭上の障害物がほとんどないか、まったくない屋外環境では、Geospatial API は利用可能な GPS 位置情報を使用して、地理空間変換を高精度で生成できる場合があります。
AR セッションの開始前に特定の水平位置での VPS の可用性を判断し、それを使用してより具体的なエクスペリエンスを創出できます。たとえば、VPS が使用可能な場合にのみ [AR を入力] ボタンを表示します。
ARCore API を有効にする
VPS が利用可能を確認するには、アプリで ARCore API を有効にする必要があります。
アプリで VPS の提供状況を確認する
Geospatial API は、デバイスが位置を特定できる場所であればどこでも使用できます。AR エクスペリエンスが VPS の受信可能範囲に左右される場合は、GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: を使用して GARVPSAvailabilityFuture（特定の水平位置での VPS の可用性を確認する非同期タスク）を取得できます。
GARVPSAvailabilityFuture を取得すると、ポーリングまたはコールバックによって結果を取得できます。
結果をポーリングする
GARFuture.state を使用して Future の状態を取得します。次の 3 つの状態があります。
GARFutureStatePending: オペレーションはまだ完了していないため、結果は不明です。GARFutureStateCancelled: オペレーションはGARFuture#cancelによってキャンセルされました。登録済みのコールバックが呼び出されることはありません。GARFutureStateDone: オペレーションが完了しました。GARVPSAvailabilityFuture.resultを使用して結果を取得します。
タスクが完了するまで、引き続き GARFuture.state をチェックしてください。
コールバックで結果を取得する
コールバックを介して Future の結果を取得することもできます。GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: を使用して、completionHandler を指定します。この completionHandler は、Future の状態が GARFutureStateDone になった直後にメインスレッドで呼び出されます。
Future をキャンセルする
GARFuture#cancel を使用して Future のキャンセルを試みます。スレッドの並列処理が原因で、キャンセルが成功しない場合があります。
GARFuture#cancel は、この試行が成功した場合は YES を、失敗した場合は NO を返します。
VPS カバレッジなしで Geospatial API を使用する
Geospatial API は、VPS がカバーされていない地域でも使用可能です。頭上の障害物がほとんどないか、まったくない屋外環境では、GPS で十分な精度のポーズを生成できます。
次のステップ
- デバイスカメラの地理空間ポーズを取得して、現実世界におけるユーザーのデバイスの正確な位置を特定します。