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

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

Geospatial API を使った独自アプリの開発ガイドについては、 Android 向け地理空間デベロッパー ガイド（Kotlin/Java） または Android NDK（C）の地理空間デベロッパー ガイド

Geospatial API の詳細については、ARCore Geospatial API の概要をご覧ください。

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

要件

デバイスのサポート

対応デバイスの一覧については、サポートされているデバイスをご覧ください。 ARCore との連携が認定されていますGeospatial API の場合、 必要なハードウェアには、Geospatial API を満たす磁力計 仕様。一部の磁力計は仕様を満たしていません。対応するデバイス 仕様外の磁力計はサポートされていません。

ソフトウェア

  • サポート対象デバイスに最新バージョンの Google Play 開発者サービス（AR）がインストールされている。

  • Android Studio バージョン 3.0 以降 Android SDK Platform バージョン 7.0（API レベル 24）以降が必要です。

  • ARCore SDK for Android は、次のいずれかの方法で入手できます。

    • ダウンロード元 GitHub マシン上で抽出します

    • 次のコマンドを使用して、リポジトリのクローンを作成します。 

      git clone https://github.com/google-ar/arcore-android-sdk.git

サンプルアプリを開いて設定する

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

  1. Android Studio の [File] メニューで [Open] をクリックします。

  2. arcore-android-sdk のプロジェクト フォルダに移動します。

  3. samples フォルダを開き、geospatial_java フォルダを選択します。 [開く] をクリックします。

Google Cloud プロジェクトの設定

ビジュアル ポジショニング システム（VPS）を使用するには、アプリを ARCore API が有効になっている Google Cloud プロジェクト。詳しくは、 Google Cloud で ARCore API を使用する 認可を設定します。キーなし認証または API キー認証を選択できます。

サンプルアプリを実行する

Android Studio でサンプルアプリを実行します。

カメラビューと、その内容に関するデバッグ情報が表示されるはずです。 デバイスの現在の地理空間ポーズ。身の回りの環境をスキャンすると 移動すると、位置精度の信頼値が変化する場合があります。 お住まいの地域が VPS の ローカライズでサポートされているかを確認します

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

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

また、VPS に対応していない地域にいる場合や、GPS 信号が不十分な場合は、アンカーを配置するためにアプリの信頼性のしきい値を調整する必要があります。

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

  1. Android Studio で GeospatialActivity を開き、 次のセクション：

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

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

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

次のステップ