Android 地理空間快速入門導覽課程

此 ARCore Geospatial API 的快速入門導覽課程說明如何執行範例應用程式 示範了 Geospatial API 的 Android Studio

如需使用 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) 以上版本

  • 適用於 Android 的 ARCore SDK 有兩種方法：

    • 下載 GitHub 然後轉換成機器

    • 使用下列指令複製存放區：

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

開啟並設定範例應用程式

針對 Android 的 ARCore SDK 所附帶的 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. 視需要調整這些值。值越高，準確率越低。

    降低準確度可讓應用程式在放置錨點時增加緯度。 詳情請見 調整姿勢準確度 瞭解詳情

後續步驟