iOS 向け地理空間のクイックスタート

この ARCore Geospatial API のクイックスタートでは、サンプルアプリを実行する方法について説明します Geospatial API を示す Xcode です。

Geospatial API を使った独自アプリの開発ガイドについては、 iOS 向け地理空間デベロッパーガイド

詳しくは、詳細については、ARCore Geospatial API の概要をご覧ください。 Geospatial API に関する情報です

ARCore を使った開発を初めて行う場合は、スタートガイドをご覧ください。

前提条件

Xcode バージョン 13.0 以降
Cocoapods を使用している場合: Cocoapods 1.4.0 以降
iOS 12.0 以降を搭載した ARKit 対応の Apple デバイス（デプロイターゲットが iOS 12.0 以降である必要があります）

で確認できます。

サンプルアプリを設定する

ARCore SDK for iOS に含まれる GeospatialExample プロジェクト Geospatial API を呼び出すコードが記述されています。

アプリケーションのクローンを作成するか、 GitHub の ARCore SDK for iOS サンプルアプリのコードを入手します。
ターミナルまたは Finder ウィンドウを開き、クローンを作成したフォルダに移動します。ダウンロードするかを選択します
arcore-ios-sdk-master/Examples フォルダに移動します。
[Examples] フォルダを開き、[GeospatialExample] フォルダを選択します。 [開く] をクリックします。

Google Cloud プロジェクトの設定

アプリでビジュアルポジショニングシステム（VPS）を使用する前に、 ARCore API を有効にします Google Cloud プロジェクト内で実行することもできますGeospatial API は API キーレス認証と API キー認証の両方に対応しています。このクイックスタートガイドでは、キーメソッド。

認可を設定する

VPS に対して Geospatial API 呼び出しを行うには、サンプルアプリに認可が必要です。制限のない API キーを使用できます。制限付き API キーを使用する場合は、 API キーに関連付けるバンドル ID を指定します。

Xcode で GeospatialExample サンプルアプリを開き、ViewController.m を開きます。ファイルを開いて「your-api-key」を検索します。
GARSession に API キーを追加する: コピーした API キーを貼り付けます。前のステップで「your-api-key」（引用符はそのまま）とし、表示:
```
self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                               bundleIdentifier:nil
                                          error:&error];
```

ARCore SDK をセットアップする

GeospatialExample アプリは、Podfile 必要な ARCore SDK と iOS のバージョン。これらの依存関係をインストールするには、ターミナルウィンドウを開き、Xcode プロジェクトがあるフォルダから pod install を実行します。

これにより、.xcworkspace ファイルが生成されます。これを使用して、。

サンプルアプリをビルドして実行する

Xcode で、GeospatialExample ワークスペースファイルを選択し、 署名と機能。
[署名を自動的に管理する] チェックボックスをオンにします。
[チーム] フィールドにチーム名を入力します。

Xcode からアプリを実行するにはデフォルトのバンドル ID を使用できますが、 GeospatialExample を独自のスタブとして使用する場合は、これを変更する必要があります。おすすめします
デバイスを接続してサンプルアプリを実行します。
.xcworkspace ファイルから GeospatialExample アプリをビルドして実行します。デバイスで起動します。

ビルドエラーを回避するには、.xcworkspace からビルドしていることを確認してください（.xcodeproj ファイルではなく）ファイルを使用します。

カメラビューと、デバイスの現在の地理空間変換を説明するデバッグ情報が表示されます。周囲の環境をスキャンする際、VPS ローカライズがサポートされている地域にいる場合は、移動するにつれて位置情報の精度に関する信頼性の値が変化することがあります。

ARCore がデバイスの位置と方角を信頼できると判断した場合は、地理空間変換を使用して、現在の位置に固定します。

VPS 情報が利用できない場合、ポジショニングの精度が低すぎることがあります。「アプリがインターネットに接続され、位置情報が VPS に認識されている必要があります。最良の結果を得るには、サンプルアプリを日中に（屋内ではなく）屋外で実行してください。

また、VPS に対応していない地域にいる場合や、GPS 信号がサポートされていない場合でも、十分な場合は、アプリの信頼度のしきい値を調整して、アンカーを配置できます

しきい値を調整するには:

Xcode で ViewController.m ファイルを開き、次のセクションに移動します。

// Thresholds for 'good enough' accuracy. These can be tuned for the
// application. We use both 'low'
// and 'high' values here to avoid flickering state changes.
static const CLLocationAccuracy kHorizontalAccuracyLowThreshold = 10;
static const CLLocationAccuracy kHorizontalAccuracyHighThreshold = 20;
static const CLLocationDirectionAccuracy kHeadingAccuracyLowThreshold = 15;
static const CLLocationDirectionAccuracy kHeadingAccuracyHighThreshold = 25;

必要に応じてこれらの値を調整します。値が大きいほど、精度は低くなります。

精度を下げると、アプリがアンカーを配置する際の自由度が広がります。詳しくは、変換の精度を調整するをご覧ください。

次のステップ

iOS 向け Geospatial デベロッパーガイドを確認し、Geospatial API を使った開発を始めましょう。