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

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 の受信可能範囲に左右される場合は、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 で十分な精度のポーズを生成できます。

次のステップ