获取设备相机的地理空间姿势

将应用设置配置为使用 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%。

后续步骤