デバイスの現在地での VPS の提供状況を確認する

Geospatial API は、VPS と GPS データを組み合わせて使用し、高精度の地理空間のポーズを生成します。API は、デバイスが位置を判断できる場所であれば、どこでも使用できます。

  • 屋内や密集した都市環境など、GPS 精度の低い地域では、API は VPS カバレッジに基づいて高精度のポーズを生成します。
  • オーバーヘッドの障害物がほとんどまたはまったくない屋外環境では、Geospatial API は利用可能な GPS 位置情報データを使用して、地理空間のポーズを高い精度で生成できます。

AR セッションを開始する前に、特定の水平位置での VPS の可用性を判断し、それを使用して、より具体的なエクスペリエンス（たとえば「AR を入力」を提示する）を作成できます。ボタンは、VPS が使用可能な場合にのみ使用できます。

ARCore API を有効にする

VPS の利用可否を確認するには、アプリで ARCore API を有効にする必要があります。

アプリで VPS が利用可能かどうか確認する

Geospatial API は、デバイスが自身の位置情報を特定できる場所であれば、どこでも使用できます。AR エクスペリエンスが VPS のカバレッジに依存している場合は、AREarthManager.CheckVpsAvailabilityAsync() を使用して VpsAvailabilityPromise を取得できます。これは、特定の水平位置で VPS の可用性を確認する非同期タスクです。 VpsAvailabilityPromise を取得したら、ポーリングによって結果を取得できます。

結果をポーリングする

VpsAvailabilityPromise.State を使用して InterruptiblePromise の状態を取得します。ステータスには次の 3 つがあります。

  • Pending: オペレーションはまだ完了していないため、結果は不明です。
  • Cancelled: オペレーションは VpsAvailabilityPromise.Cancel() によってキャンセルされました。登録済みのコールバックが呼び出されることはありません。
  • Done: オペレーションは完了しています。VpsAvailabilityPromise.Result を使用して結果を取得します。

タスクが完了するまで、引き続き VpsAvailabilityPromise.State をチェックできます。

InterruptiblePromise をキャンセル

VpsAvailabilityPromise.Cancel() を使用して InterruptiblePromise のキャンセルを試みます。スレッドの並列処理が原因で、キャンセルの試行が実際には成功しない場合があります。

VPS カバレッジなしで Geospatial API を使用する

Geospatial API は、VPS がカバーされていない地域でも使用できます。オーバーヘッドの障害物がほとんどない、またはまったくない屋外環境では、GPS で高精度のポーズを生成できます。

次のステップ