AI-generated Key Takeaways
-
Obtain the device camera's
GAREarth.cameraGeospatialTransform
from aGAREarth
object to get location, altitude, and approximate orientation. -
The
GAREarth.cameraGeospatialTransform
includes location (latitude and longitude), altitude, and an orientation in the EUS coordinate system. -
While pitch and roll angles are generally precise, yaw angles may vary depending on VPS data and conditions, requiring potential adjustments for accuracy.
-
GARGeospatialTransform.orientationYawAccuracy
provides the radius of uncertainty in degrees for the local-level yaw angle estimate.
Once you have configured your app's settings to use the Geospatial API, you can obtain the device camera's GAREarth.cameraGeospatialTransform
. This transform, managed in a GAREarth
object, contains the following information:
- Location, expressed in latitude and longitude
- Altitude
- An orientation approximating the direction the user is facing in the EUS coordinate system with X+ pointing east, Y+ pointing up, and Z+ pointing south
Adjust the pose for accuracy
When the device is upright in the default orientation, the pitch (X+) and roll (Z+) angles tend to be precise due to a natural alignment with AR tracking. However, the yaw (Y+) angles can vary depending on VPS data availability and temporal conditions at the location. Your app may have to make adjustments for accuracy.
GARGeospatialTransform.orientationYawAccuracy
provides the radius of uncertainty for GARGeospatialTransform.eastUpSouthQTarget
, measured in degrees. This value indicates the standard deviation of the estimate for the local-level yaw (Y+) angle.
What's next
- Place a Geospatial anchor by obtaining the anchor's Geospatial pose.