getPose
Declaration
Summary
Returns
The pose in ARKit tracking space corresponding to the given geolocation, with
translation in meters from the tracking space origin, or nil if VPS2 has not
localized yet.
Parameters
| Name | Type | Summary |
|---|---|---|
| location | GeolocationData | The geolocation to convert. |
Overload 1
Summary
Converts a CLLocation to an AR pose using the latest localization.
Returns
The pose in the device's AR tracking space, with translation in meters, or
nil if VPS2 has not localized yet.
Parameters
| Name | Type | Summary |
|---|---|---|
| location | CLLocation | The CLLocation to convert. Its ellipsoidalAltitude (WGS84) isused, not its mean sea level altitude. |
Overload 2
Summary
Converts a geolocation to an AR pose using the provided 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 ARKit tracking space corresponding to the given geolocation, with
translation in meters from the tracking space origin, or nil if localization has
no tracking state.
Parameters
| Name | Type | Summary |
|---|---|---|
| localization | Vps2Localization | The localization to use for the conversion. |
| location | GeolocationData | The geolocation to convert. |
Overload 3
Summary
Converts a CLLocation to an AR pose using the provided localization snapshot.
Returns
The pose in the device's AR tracking space, with translation in meters, or
nil if localization has no tracking state.
Parameters
| Name | Type | Summary |
|---|---|---|
| localization | Vps2Localization | The localization to use for the conversion. |
| location | CLLocation | The CLLocation to convert. Its ellipsoidalAltitude (WGS84) is used,not its mean sea level altitude. |
Overload 4
Summary
Converts a coordinate and altitude to an AR pose using the latest localization.
Returns
The pose in the device's AR tracking space, with translation in meters, or
nil if VPS2 has not localized yet.
Parameters
| Name | Type | Summary |
|---|---|---|
| coordinate | CLLocationCoordinate2D | The coordinate to convert. |
| altitude | Double | The altitude in meters above the WGS84 ellipsoid (not mean sea level). When taking it from a CLLocation, use ellipsoidalAltitude, not altitude.Defaults to 0. |
Overload 5
Summary
Converts a coordinate and altitude to an AR pose using the provided localization snapshot.
Returns
The pose in the device's AR tracking space, with translation in meters, or
nil if localization has no tracking state.
Parameters
| Name | Type | Summary |
|---|---|---|
| localization | Vps2Localization | The localization to use for the conversion. |
| coordinate | CLLocationCoordinate2D | The coordinate to convert. |
| altitude | Double | The altitude in meters above the WGS84 ellipsoid (not mean sea level). When taking it from a CLLocation, use ellipsoidalAltitude, not altitude.Defaults to 0. |
Converts a geolocation to an AR pose using the latest localization.
Equivalent to
getPose(localization:location:)withgetLatestLocalization().locationcan be any geolocation, not just the device's; the result does not depend onthe current camera pose.