設定應用程式使用 Geospatial API 後,您可以呼叫 ArEarth_getCameraGeospatialPose
取得 ArGeospatialPose
,說明裝置在最新影格中相機的地理空間定位。這個姿勢會在 ArEarth
物件中管理,並包含下列資訊:
- 以經緯度表示的位置
- 海拔高度
- 方向大致上與使用者在 EUS 座標系統中面向的方向相同,其中 X+ 指向東方、Y+ 指向上方,而 Z+ 指向南方
查看追蹤狀態
地理空間值只有在 ArEarth.ArTrackingState
為 ArTrackingState.AR_TRACKING_STATE_TRACKING
,且 ArEarth.ArEarthState
為 AR_EARTH_STATE_ENABLED
時才有效。請務必將所有 Geospatial API 呼叫包裝在 ArEarth.ArTrackingState
控制區塊中。
if (ar_earth != NULL) { ArTrackingState earth_tracking_state = AR_TRACKING_STATE_STOPPED; ArTrackable_getTrackingState(ar_session, (ArTrackable*)ar_earth, &earth_tracking_state); if (earth_tracking_state == AR_TRACKING_STATE_TRACKING) { ArGeospatialPose* camera_geospatial_pose = NULL; ArGeospatialPose_create(ar_session, &camera_geospatial_pose); ArEarth_getCameraGeospatialPose(ar_session, ar_earth, camera_geospatial_pose); // camera_geospatial_pose contains geodetic location, rotation, and // confidences values. ArGeospatialPose_destroy(camera_geospatial_pose); } }
如果 ArEarth.ArTrackingState
未變成 ArTrackingState.AR_TRACKING_STATE_TRACKING
,ArEarth.ArTrackingState
可能會是 AR_TRACKING_STATE_PAUSED
或 AR_TRACKING_STATE_STOPPED
。如果上述兩種情況都不成立,請檢查 ArEarth.ArEarthState
,這會顯示其他可能導致 ArEarth
物件無法追蹤的錯誤狀態。
調整姿勢以提高準確度
當裝置以預設方向直立時,由於 AR 追蹤會自然對齊,因此傾斜 (X+) 和滾動 (Z+) 角度通常會精確。不過,偏航角 (Y+) 可能會因 VPS 資料可用性和位置的時間條件而異。應用程式可能需要進行調整以提高準確度。
ArGeospatialPose_getOrientationYawAccuracy()
會針對特定 ArGeospatialPose
提供偏航 (Y+) 角度的預估精確度。方向偏轉精確度是指 ArGeospatialPose_getEastUpSouthQuaternion()
傳回的偏轉角度周圍 68 百分位信心水準的半徑 (以度為單位)。換句話說,ArGeospatialPose
的實際偏航角正確的機率為 68%。
值越大,準確度越低。舉例來說,如果預估偏轉角度為 60 度,且偏轉精確度為 10 度,則實際偏轉角度介於 50 和 70 度之間的機率為 68%。
後續步驟
- 取得錨點的地理空間姿勢,放置地理空間錨點。