TryGetPose
Declaration
Summary
Remarks
LocationInfo.altitude is passed through unconverted, but NSDK expects altitude above
the WGS84 ellipsoid. On iOS, Unity reports mean sea level altitude, so the resulting pose can
be off vertically by tens of meters; use the overload taking an explicit ellipsoidal altitude
instead.
Returns
false if the subsystem is unavailable or VPS2 has not localized yet.
Parameters
| Name | Type | Summary |
|---|---|---|
| location | LocationInfo | The LocationInfo containing latitude, longitude, and altitude. |
| poseOut | out XRVps2Pose | Receives the AR pose on success. |
Overload 1
Summary
Attempts to convert a position and orientation in the global coordinate system to a
pose in AR session space, using the latest VPS2 localization.
Remarks
The geolocation can be any location, not just the device's; the result does not depend
on the current camera pose.
Returns
false if the subsystem is unavailable or VPS2 has not localized yet.
Parameters
| Name | Type | Summary |
|---|---|---|
| latitude | double | WGS84 latitude, in degrees. |
| longitude | double | WGS84 longitude, in degrees. |
| altitude | double | Altitude in meters above the WGS84 ellipsoid (not mean sea level). |
| orientationEdn | Quaternion | Orientation relative to the local East-Down-North frame, passed to NSDK as is: it is not in Unity axes. Quaternion.identity aligns the pose with that frame. |
| poseOut | out XRVps2Pose | Receives the pose of the given geolocation in AR session space, with position in meters. |
Overload 2
Summary
Attempts to convert a position and orientation in the global coordinate system to a
pose in AR session space, using the supplied localization snapshot.
Remarks
The pose is in AR session space, not Unity world space. To place a world-space
transform at it, compose it with the XR origin first via
origin.TrackablesParent.TransformPose. In most cases you want the overload
that uses the latest localization automatically; use this one only when a batch of
geolocations must share a single snapshot. Throws if
localization is unavailable. The geolocation can be any location,
not just the device's; the result does not depend on the current camera pose.
Returns
true if the subsystem exists; otherwise false.
Parameters
| Name | Type | Summary |
|---|---|---|
| localization | XRVps2Localization | The localization snapshot to use for conversion. |
| latitude | double | WGS84 latitude, in degrees. |
| longitude | double | WGS84 longitude, in degrees. |
| altitude | double | Altitude in meters above the WGS84 ellipsoid (not mean sea level). |
| orientationEdn | Quaternion | Orientation relative to the local East-Down-North frame, passed to NSDK as is: it is not in Unity axes. Quaternion.identity aligns the pose with that frame. |
| poseOut | out XRVps2Pose | Receives the pose of the given geolocation in AR session space, with position in meters. |
Attempts to convert a Unity LocationInfo to a pose in AR session space, using the
latest VPS2 localization.