适用于 Android 的地理空间快速入门

本 ARCore Geospatial API 快速入门将向您展示如何在 Android Studio 中运行演示 Geospatial API 的示例应用。

如需了解如何使用 Geospatial API 开发自己的应用，请参阅 适用于 Android (Kotlin/Java) 的地理空间开发者指南或 适用于 Android NDK (C) 的地理空间开发者指南。

如需详细了解 Geospatial API，请参阅 ARCore Geospatial API 简介。

如果您是初次使用 ARCore 进行开发，请参阅使用入门。

要求

设备支持

如需查看支持的设备的完整列表，请参阅支持的设备 经过认证，可与 ARCore 配合使用。对于 Geospatial API，其中一个关键点是 是满足 Geospatial API 要求的磁力计， 。某些磁力计不符合规格；搭载这些系统的设备 不支持不符合规格的磁力计。

软件

  • 最新版本的 面向 AR 的 Google Play 服务 支持的设备上已安装。

  • 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 文件夹，然后点击 Open。

设置 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. 可根据需要调整这些值。值越高，准确率越低。

    降低精确度可让应用在放置锚点时有更大的自由度。如需了解详情，请参阅调整姿势准确性。

后续步骤