如果使用 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 街景服務最近拍攝的影像相比,該區域可能因基礎設施工程而有重大變化。