排查 Geospatial API 的问题

适用的 XR 设备
本指南可帮助您为以下类型的 XR 设备打造优质体验。
有线扩展现实眼镜
音频和
显示眼镜

如果您在使用 Geospatial API 时遇到问题,可以采取以下一些常见步骤。

API 密钥授权始终不成功

如果 API 密钥授权无法正常运行,请按以下步骤操作:

  • 确保您已在 Google Cloud 中为正确的项目启用 ARCore API。
  • 如果您启用了任何 API 密钥限制,请暂时停用这些限制。
  • 使用 APK 分析器验证应用的 build 中是否包含 API 密钥。它必须位于应用 AndroidManifest.xml 的 <application> 元素中的 <meta-data> 元素内:

    <meta-data
      android:name="com.google.android.ar.API_KEY"
      android:value="API_KEY"/>
    
  • 确保项目的凭据中列出的 API 密钥与应用使用的 API 密钥完全一致,不含空格或任何其他字符。

地理空间定位质量始终无法达到预期值

如果 Geospatial API 返回的姿势质量未达到预期结果,可能的原因如下:

  • 该区域未由官方 Google 街景来源进行映射。
    • 如需检查,请打开 Google 地图,然后在预期定位位置附近进入街景模式。街景图像的提供方必须是 Google 街景。VPS 不会考虑其他来源。
  • 该区域位于受限地区。
  • 该区域没有足够的符合条件的特征点。
    • VPS 仅使用不太可能在很长一段时间内发生变化的高质量特征点。例如,树木的外观在一年中可能会发生很大变化,因此不适合用作特征点。
    • 与 Google 街景最近拍摄的画面相比,该区域可能因基础设施工程而发生了重大变化。