GARGeospatialTransform
A representation of a global transform including location, orientation, altitude, and accuracy estimates.
Can be obtained from GAREarth.cameraGeospatialTransform
, or from geospatialTransformFromTransform:error: (GARSession(Geospatial))
.
Summary
Inheritance
Inherits from:NSObject
Properties
CLLocationDistance
CLLocationCoordinate2D
simd_quatf
CLLocationDirection
eastUpSouthQTarget
to get the quaternion from target to East-Up-South (EUS) coordinates instead. To determine a value analogous to the heading value, calculate the yaw, pitch, and roll values from eastUpSouthQTarget
. When the device is pointing downwards, i.e. perpendicular to the ground, heading is analoguous to roll, and when the device is upright in the device's default orientation mode, heading is analogous to yaw. CLLocationDirectionAccuracy
GARGeospatialTransform
from GAREarth.cameraGeospatialTransform
, and is 0 for all other GARGeospatialTransform
objects. To get the yaw uncertainty, use orientationYawAccuracy
instead, which is analogous to the heading accuracy when the device is held upright in the default orientation mode.
CLLocationAccuracy
CLLocationDirectionAccuracy
CLLocationAccuracy
Properties
altitude
Current estimate of altitude in reference to the WGS84 ellipsoid .
Note: This can be compared to CLLocation.ellipsoidalAltitude
, NOT CLLocation.altitude
.
eastUpSouthQTarget
The quaternion from the target to East-Up-South (EUS) coordinates (i.e., +X points east, +Y points up, and +Z points south).
An identity quaternion will have the target frame oriented such that X+ points to the east, Y+ points up away from the center of the earth, and Z+ points to the south.
heading
Current estimate of heading.
North is 0°, East is 90°, and the angle continues to increase clockwise. The range is [0,360)
.
This is valid only for GARGeospatialTransform
from GAREarth.cameraGeospatialTransform
, and is 0 for all other GARGeospatialTransform
objects.
Deprecated.
Use eastUpSouthQTarget
to get the quaternion from target to East-Up-South (EUS) coordinates instead. To determine a value analogous to the heading value, calculate the yaw, pitch, and roll values from eastUpSouthQTarget
. When the device is pointing downwards, i.e. perpendicular to the ground, heading is analoguous to roll, and when the device is upright in the device's default orientation mode, heading is analogous to yaw.
headingAccuracy
The radius of uncertainty for GARGeospatialTransform.heading
, measured in degrees.
The GARGeospatialTransform.heading
identifies the mean of the heading estimate and this value indicates the standard deviation of the estimate.
Deprecated.
This is valid only for GARGeospatialTransform
from GAREarth.cameraGeospatialTransform
, and is 0 for all other GARGeospatialTransform
objects. To get the yaw uncertainty, use orientationYawAccuracy
instead, which is analogous to the heading accuracy when the device is held upright in the default orientation mode.
horizontalAccuracy
The radius of uncertainty for GARGeospatialTransform.coordinate
, measured in meters.
The GARGeospatialTransform.coordinate
identifies the center of the circle, and this value indicates the radius of that circle.
orientationYawAccuracy
Gets the radius of uncertainty for the orientation's yaw angle accuracy, measured in degrees of standard deviation from the estimate.
Yaw rotation is the angle between the transform's compass direction and north, and can be determined from eastUpSouthQTarget
.
verticalAccuracy
The radius of uncertainty for GARGeospatialTransform.altitude
, measured in meters.
The GARGeospatialTransform.altitude
identifies the mean of the altitude estimate and this value indicates the standard deviation of the estimate.
