Skip to main content
←API Reference ←com.nianticspatial.nsdk.vps2 ←Vps2Session

getGeolocation


Declaration​

fun getGeolocation(pose: Pose): Vps2GeolocationData?

Summary​

Convert an AR pose to a geolocation using the latest localization. The inverse of
getPose. pose can be any pose in AR tracking space (ARCore's coordinate convention, in
meters), not just the camera's.


The heading is the direction of the pose's forward axis projected onto the horizontal
plane, which matches HeadingMode.CAMERA_DIRECTION in getDeviceGeolocation.
HeadingMode.DEVICE_TOP is not offered because it depends on the display orientation, which
an arbitrary pose does not have. The heading is not meaningful when the forward axis points
straight up or down, or close to it.

Returns​

The latitude, longitude, altitude, heading and orientation of pose (with its tracking state and accuracy), or null if VPS2 has not localized yet.

Throws​

  • NsdkInvalidArgumentStatusException — if pose has a non-finite component or a zero-length rotation.

Parameters​

NameTypeSummary
posePose
-