Geospatial API に関する問題のトラブルシューティング

対象となる XR デバイス
このガイダンスは、次のようなタイプの XR デバイス向けのエクスペリエンスを構築する際に役立ちます。
有線 XR グラス
オーディオ&
ディスプレイ グラス

Geospatial API で問題が発生した場合は、次の一般的な手順をお試しください。

API キーの認可が成功しない

API キー認証が機能しない場合は、次の手順に沿って操作します。

  • Google Cloud の適切なプロジェクトで ARCore API が有効になっていることを確認します。
  • API キーの制限が有効になっている場合は、一時的に無効にします。
  • APK Analyzer を使用して、API キーがアプリのビルドに含まれていることを確認します。アプリの AndroidManifest.xml の <application> 要素内の <meta-data> 要素に含める必要があります。

    <meta-data
      android:name="com.google.android.ar.API_KEY"
      android:value="API_KEY"/>
    
  • プロジェクトの認証情報に記載されている API キーが、アプリで使用されている API キーと完全に一致していることを確認します。スペースやその他の文字が含まれていないことを確認してください。

Geospatial ローカライズの品質が期待値に達しない

Geospatial API から返されるポーズの品質が期待どおりの結果に達しない場合は、次の原因が考えられます。

  • このエリアは、Google ストリートビューの公式ソースによってマッピングされていません。
    • 確認するには、Google マップを開き、想定されるローカライズ位置の近くでストリートビューを表示します。ストリートビューの画像の帰属表示は Google ストリートビューにする必要があります。その他のソースは VPS では考慮されません。
  • このエリアは制限区域内にあります。
  • エリアに十分な対象特徴点がない。
    • VPS は、長期間にわたって変化する可能性が低い高品質の特徴点のみを使用します。たとえば、木は 1 年を通して外観が大きく変化するため、特徴点として使用するには適していません。
    • インフラ工事により、Google ストリートビューの最近の撮影画像と比較して、エリアが大幅に変化している可能性があります。