iOS アプリで Geospatial API を有効にする

Geospatial API を使用できるように、アプリの設定を構成します。

前提条件

AR の基礎的なコンセプトを理解しておいてください。 と ARCore セッションを構成する方法を確認してください。

上記の機能のデモンストレーションを実行する場合は、 詳細については、 iOS 向け ARCore Geospatial クイックスタート

詳しくは、 Geospatial API の概要 Geospatial API に関する情報です

ARCore を使った開発を初めて行う場合は、スタートガイドをご覧ください。 でソフトウェアとハードウェアの要件、前提条件、 使用しているプラットフォームに固有のその他の情報

ARCore API を有効にする

アプリでビジュアル ポジショニング システム（VPS）を使用する前に、 ARCore API を有効にします Google Cloud プロジェクトで管理されます。このサービスは 地理空間アンカーのホスティング、保存、解決です。

キーレス認証が推奨されますが、API キー認証もサポートされています。

必要なライブラリをアプリに追加する

アプリでの ARCore API の呼び出しを承認したら、次にライブラリを アプリで地理空間機能を有効にします。

アプリの Podfile を更新して、ARCore SDK とサポートされている iOS を含めます 説明します。手順は次のとおりです。

  1. 次の platform と pod を プロジェクトの Podfile:

    platform :ios, '11.0'
pod 'ARCore/Geospatial', '~> 1.45.0'

    iOS 10 をサポートする場合は、platform :ios, '10.0' を指定することもできます。 Geospatial API は iOS 11 以上のランタイムでのみ機能します。

  2. ターミナル ウィンドウを開き、次のフォルダから pod install を実行します。 Xcode プロジェクトが存在すること。

    これにより、ビルドと実行に使用する .xcworkspace ファイルが生成されます。 アプリを実行します。

必ず、開発環境が ARCore SDK の要件を満たしていることを確認してください。 クイックスタートをご覧ください。

セッション構成で地理空間機能を有効にする

デバイスの互換性を確認する

ARCore をサポートするデバイスがすべて Geospatial API をサポートしているわけではありません。 クイックスタートをご覧ください。

使用 GARSession.isGeospatialModeSupported: デバイスを確認します。

if (![self.garSession isGeospatialModeSupported:GARGeospatialModeEnabled]) {
  [self setErrorStatus:@"GARGeospatialModeEnabled is not supported on this device."];
  return;
}

GARSessionConfiguration *configuration = [[GARSessionConfiguration alloc] init];
configuration.geospatialMode = GARGeospatialModeEnabled;
[self.garSession setConfiguration:configuration error:&error];
if (error) {
  [self setErrorStatus:[NSString stringWithFormat:@"Failed to configure GARSession: %d",
                                                  (int)error.code]];
  return;
}

実行時に位置情報の利用許可をユーザーに求める

アプリは、以下の位置情報の利用許可を実行時にリクエストする必要があります。 セッションを構成します。

デバイスの現在地での地理空間の利用状況を確認する

Geospatial API は VPS と GPS を組み合わせて地理空間変換を判断するため、デバイスが自身の位置情報を特定できる限り、API を使用できます。屋内や密集した都市環境などの GPS 精度の低い地域では、API は VPS カバレッジに基づいて高精度の変換を生成します。一般的な条件下で、VPS の位置精度は約 5 メートル、回転精度は 5 度であると期待できます。GARSession.checkVPSAvailabilityAtCoordinate:completionHandler: を使用すると、特定のビジネスが VPS の対象かどうかを判断できます。

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

次のステップ