Obtén la pose geoespacial de la cámara del dispositivo

Una vez que hayas configurado la app para usar la API de Geospatial, puedes llamar a ArEarth_getCameraGeospatialPose para obtener un ArGeospatialPose que describa el posicionamiento geoespacial del dispositivo para la cámara en el fotograma más reciente. Esta pose, administrada en un objeto ArEarth, contiene la siguiente información:

  • Ubicación, expresada en latitud y longitud
  • Altitud
  • Una orientación que aproxima la dirección a la que se enfrenta el usuario en el sistema de coordenadas EUS, con X+ apuntando al este, Y+ apuntando hacia arriba y Z+ apuntando al sur

Verifica el estado del seguimiento

Los valores geoespaciales solo son válidos mientras ArEarth.ArTrackingState sea ArTrackingState.AR_TRACKING_STATE_TRACKING y ArEarth.ArEarthState sea AR_EARTH_STATE_ENABLED. Asegúrate de unir todas las llamadas a la API de Geospatial en un bloque de control 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);
  }
}

Si ArEarth.ArTrackingState no se convierte en ArTrackingState.AR_TRACKING_STATE_TRACKING, ArEarth.ArTrackingState puede ser AR_TRACKING_STATE_PAUSED o AR_TRACKING_STATE_STOPPED. Si ninguna de estas condiciones es verdadera, verifica ArEarth.ArEarthState, que muestra otros estados de error que pueden impedir que el objeto ArEarth realice un seguimiento.

Ajusta la pose para mayor precisión

Cuando el dispositivo está en posición vertical en la orientación predeterminada, los ángulos de inclinación (X+) y de balanceo (Z+) suelen ser precisos debido a una alineación natural con el seguimiento de RA. Sin embargo, los ángulos de guiñada (Y+) pueden variar según la disponibilidad de los datos de VPS y las condiciones temporales en la ubicación. Es posible que tu app deba realizar ajustes para mejorar la precisión.

ArGeospatialPose_getOrientationYawAccuracy() proporciona una estimación de precisión para los ángulos de guiñada (Y+) para un ArGeospatialPose determinado. La precisión del guiñada de orientación es un número que describe el radio, en grados, del nivel de confianza del percentil 68 alrededor de los ángulos de guiñada que se muestran en ArGeospatialPose_getEastUpSouthQuaternion(). En otras palabras, hay una probabilidad del 68% de que el ángulo de guiñada real de ArGeospatialPose sea preciso.

Los valores más altos indican una menor precisión. Por ejemplo, si el ángulo de guiñada estimado es de 60 grados y la precisión de guiñada es de 10 grados, existe una probabilidad del 68% de que el ángulo de guiñada real esté entre 50 y 70 grados.

¿Qué sigue?