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.