peek_signaled_gps_nmea


Description:

[ Version ( since = "1.18" ) ]
public unowned LocationGpsNmea peek_signaled_gps_nmea ()

Gets a LocationGpsNmea object with the current GPS NMEA location information.

Unlike get_gps_nmea or get_gps_nmea_sync, this method does not perform an explicit query. Instead, this method will return the location information that may have been signaled by the modem. Therefore, this method will only succeed if location signaling is enabled (e.g. with setup in the ModemLocation).

Warning:

The returned value is only valid until the property changes so it is only safe to use this function on the thread where this was constructed. Use get_signaled_gps_nmea if on another thread.

Parameters:

this

A ModemLocation.

Returns:

A LocationGpsNmea, or null if none available. Do not free the returned value, it belongs to this.