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

Una vez que hayas configurado los parámetros de tu app para usar la API de Geospatial, puedes llamar a Earth.getCameraGeospatialPose() para obtener un GeospatialPose que describa la posición geoespacial del dispositivo para la cámara en el fotograma más reciente. Esta pose, administrada en un objeto Earth, 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

Cómo comprobar el estado de seguimiento

Los valores geoespaciales solo son válidos mientras Earth.TrackingState sea TrackingState.TRACKING. Asegúrate de unir todas las llamadas a la API de Geospatial en un bloque de control Earth.TrackingState.

Java

if (earth != null && earth.getTrackingState() == TrackingState.TRACKING) {
  GeospatialPose cameraGeospatialPose = earth.getCameraGeospatialPose();
  // cameraGeospatialPose contains geodetic location, rotation, and confidences values.
}

Kotlin

if (earth.trackingState == TrackingState.TRACKING) {
  val cameraGeospatialPose = earth.cameraGeospatialPose
  // cameraGeospatialPose contains geodetic location, rotation, and confidences values.
}

Si Earth.TrackingState no se convierte en TrackingState.TRACKING, Earth.TrackingState puede ser TrackingState.PAUSED o TrackingState.STOPPED. Si no se cumple ninguna de estas condiciones, revisa Earth.Earthstate, que muestra otros estados de error que podrían impedir que se realice el seguimiento del objeto Earth.

Ajusta la postura para lograr una mayor precisión

Cuando el dispositivo está derecho en la orientación predeterminada, los ángulos de inclinación (X+) y enrollado (Z+) tienden a 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 datos de VPS y las condiciones temporales de la ubicación. Es posible que tu app deba realizar ajustes para mejorar su precisión.

GeospatialPose.getOrientationYawAccuracy() proporciona una estimación de precisión para los ángulos de guiñada (Y+) para un GeospatialPose determinado. La precisión de la 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 de GeospatialPose.getEastUpSouthQuaternion(). En otras palabras, hay una probabilidad del 68% de que el ángulo de guiñada verdadero de GeospatialPose 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?