排解 Geospatial API 問題

適用的 XR 裝置
本指南可協助您為這類 XR 裝置打造體驗。
有線 XR 眼鏡
音訊和
顯示型眼鏡

如果使用 Geospatial API 時遇到問題,請嘗試下列常見步驟。

API 金鑰授權一律失敗

如果 API 金鑰授權無法運作,請按照下列步驟操作:

  • 確認您已在 Google Cloud 的正確專案中啟用 ARCore API。
  • 如果已啟用任何 API 金鑰限制,請暫時停用。
  • 使用 APK 分析工具,確認應用程式版本中是否包含 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 街景服務最近拍攝的影像相比,該區域可能因基礎設施工程而有重大變化。