niSync_GetLocation

C Function Prototype

ViStatus _VI_FUNC niSync_GetLocation (ViSession vi, ViReal64 * latitude, ViReal64 * longitude, ViReal64 * altitude);

Purpose

Returns the last calculated latitude, longitude, and altitude of the device's onboard GPS receiver.

Note Note  
  • You must connect an external GPS antenna to the device and set the device's external time reference to GPS in order to receive valid data from this function. For best results, allow the GPS receiver to compete a self survey before reading the location.
  • This attribute is supported only on certain targets. Refer to Target Support for Timing Attributes and Functions to determine whether or not this attribute is supported on your target.

Parameters

Name Type Description
vi ViSession The session handle that you obtain from niSync_init. The handle identifies a particular instrument session.
latitude ViReal64 * The current latitude, in degrees, of the connected device's GPS receiver. Negative values represent southern latitude. Positive values represent northern latitude. This parameter is an input double pointer; the caller of this function must allocate a ViReal64 and pass the pointer in this argument.
longitude ViReal64 * The current longitude, in degrees, of the connected device's GPS receiver. Negative values represent western longitude. Positive values represent eastern longitude. This parameter is an input double pointer; the caller of this function must allocate a ViReal64 and pass the pointer in this argument.
altitude ViReal64 * The current altitude, in meters, of the connected device's GPS receiver using the WGS-84 earth ellipsoid standard. This parameter is an input double pointer; the caller of this function must allocate a ViReal64 and pass the pointer in this argument.

Return Values