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

這個 ARCore Geospatial API 快速入門導覽課程說明如何在 Android Studio 中執行示範地理空間 API 的範例應用程式。

如需使用地理空間 API 開發應用程式的指南，請參閱 Android 地理空間開發人員指南 (Kotlin/Java) 或 Android NDK 的地理空間開發人員指南。

如要進一步瞭解地理空間 API，請參閱「ARCore Geospatial API 簡介」。

如果您是第一次使用 ARCore 進行開發，請參閱入門指南。

需求條件

裝置支援

如需可與 ARCore 搭配使用的裝置完整清單，請參閱支援的裝置。針對地理空間 API，地理空間 API 所需的其中一項關鍵是滿足地理空間 API 規格的磁力儀。部分磁力儀不符合規格；不支援具有這些規格磁性計的裝置。

軟體

  • 支援的裝置上安裝的最新版 Google Play 服務 - AR 適用。

  • 搭載 Android SDK Platform 7.0 (API 級別 24) 以上版本的 Android Studio 3.0 以上版本

  • ARCore SDK for Android，提供以下其中一種方法：

    • 從 GitHub 下載這個目錄，然後將檔案解壓縮至您的電腦。

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

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

開啟並設定範例應用程式

ARCore SDK for Android 包含的 geospatial_java 專案會說明呼叫地理空間 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. 請視需要調整這些值。值越大，準確率越低。

    降低精確度可讓應用程式增加錨定標記的緯度。詳情請參閱「調整姿勢準確度」一文。

後續步驟