getPose
Declaration
Summary
Returns
The pose in AR tracking space (with its tracking state and accuracy), or null if VPS2 has not localized yet.
Parameters
| Name | Type | Summary |
|---|---|---|
| location | GeolocationData | The geolocation to use for the pose calculation (WGS84; altitude in meters above the WGS84 ellipsoid). |
Overload 1
Summary
Convert an Android Location to an AR pose using the latest localization.
Location.getAltitude is already height above the WGS84 ellipsoid, as NSDK expects.
location carries no orientation, so the pose is aligned with East-Down-North.
Returns
The pose in AR tracking space (with its tracking state and accuracy), or null if VPS2 has not localized yet.
Parameters
| Name | Type | Summary |
|---|---|---|
| location | Location | - |
Overload 2
Summary
Convert a geolocation to an AR pose using a localization snapshot.
location can be any geolocation, not just the device's; the result is where that
geolocation lies in AR tracking space, and does not depend on the current camera pose.
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.
Returns
The pose in AR tracking space (ARCore's coordinate convention), with translation in meters from the tracking space origin.
Throws
NsdkInvalidOperationStatusException— if the current localization tracking state isVps2TrackingState.UNAVAILABLE.
Parameters
| Name | Type | Summary |
|---|---|---|
| localization | Vps2Localization | - |
| location | GeolocationData | The geolocation to use for the pose calculation (WGS84; altitude in meters above the WGS84 ellipsoid). |
Overload 3
Summary
Convert an Android Location to an AR pose using a localization snapshot.
Location.getAltitude is already height above the WGS84 ellipsoid, as NSDK expects.
location carries no orientation, so the pose is aligned with East-Down-North.
Returns
The pose in AR tracking space (ARCore's coordinate convention), with translation in meters from the tracking space origin.
Throws
NsdkInvalidOperationStatusException— if the current localization tracking state isVps2TrackingState.UNAVAILABLE.
Parameters
| Name | Type | Summary |
|---|---|---|
| localization | Vps2Localization | - |
| location | Location | - |
Convert a geolocation to an AR pose using the latest localization.
locationcan be any geolocation, not just the device's; the result does not depend on thecurrent camera pose.