Geospatial API は、VPS と GPS データを組み合わせて、高精度の地理空間変換を生成します。この 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 だけでも高い精度でポーズを生成できる場合があります。
次のステップ
- デバイスのカメラの地理空間ポーズを取得して、ユーザーのデバイスが現実世界で正確にどこにあるかを特定します。