| Top |  |  |  |  | 
| struct | MMModemLocation | 
| #define | MM_LOCATION_LONGITUDE_UNKNOWN | 
| #define | MM_LOCATION_LATITUDE_UNKNOWN | 
| #define | MM_LOCATION_ALTITUDE_UNKNOWN | 
MMModemLocation implements GDBusInterface, GInitable, GAsyncInitable and MmGdbusModemLocation.
The MMModemLocation is an object providing access to the methods, signals and properties of the Location interface.
The Location interface is exposed whenever a modem has location capabilities.
const gchar *
mm_modem_location_get_path (MMModemLocation *self);
Gets the DBus path of the MMObject which implements this interface.
gchar *
mm_modem_location_dup_path (MMModemLocation *self);
Gets a copy of the DBus path of the MMObject object which implements this interface.
MMModemLocationSource
mm_modem_location_get_capabilities (MMModemLocation *self);
Gets a bitmask of the location capabilities supported by this MMModemLocation.
MMModemLocationSource
mm_modem_location_get_enabled (MMModemLocation *self);
Gets a bitmask of the location capabilities which are enabled in this MMModemLocation.
gboolean
mm_modem_location_signals_location (MMModemLocation *self);
Gets the status of the location signaling in the MMModemLocation.
void mm_modem_location_setup (MMModemLocation *self,MMModemLocationSource sources,gboolean signal_location,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously configures the location sources to use when gathering location information. Also enable or disable location information gathering.
When the operation is finished, callback
 will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_location_setup_finish() to get the result of the operation.
See mm_modem_location_setup_sync() for the synchronous, blocking version of this method.
| self | ||
| sources | Bitmask of MMModemLocationSource values specifying which locations should get enabled. | |
| signal_location | Flag to enable or disable location signaling. | |
| cancellable |  A GCancellable or  | [allow-none] | 
| callback | A GAsyncReadyCallback to call when the request is satisfied or  | |
| user_data | User data to pass to  | 
gboolean mm_modem_location_setup_finish (MMModemLocation *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_location_setup().
| self | ||
| res | The GAsyncResult obtained from the GAsyncReadyCallback passed to  | |
| error | Return location for error or  | 
gboolean mm_modem_location_setup_sync (MMModemLocation *self,MMModemLocationSource sources,gboolean signal_location,GCancellable *cancellable,GError **error);
Synchronously configures the location sources to use when gathering location information. Also enable or disable location information gathering.
The calling thread is blocked until a reply is received. See mm_modem_location_setup()
for the asynchronous version of this method.
| self | ||
| sources | Bitmask of MMModemLocationSource values specifying which locations should get enabled. | |
| signal_location | Flag to enable or disable location signaling. | |
| cancellable |  A GCancellable or  | [allow-none] | 
| error | Return location for error or  | 
void mm_modem_location_get_3gpp (MMModemLocation *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously gets the current 3GPP location information.
When the operation is finished, callback
 will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_location_get_3gpp_finish() to get the result of the operation.
See mm_modem_location_get_3gpp_sync() for the synchronous, blocking version of this method.
| self | ||
| cancellable |  A GCancellable or  | [allow-none] | 
| callback | A GAsyncReadyCallback to call when the request is satisfied or  | |
| user_data | User data to pass to  | 
MMLocation3gpp * mm_modem_location_get_3gpp_finish (MMModemLocation *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_location_get_3gpp().
| self | ||
| res | The GAsyncResult obtained from the GAsyncReadyCallback passed to  | |
| error | Return location for error or  | 
 A MMLocation3gpp, or NULL if not available. The returned value should be freed with g_object_unref(). 
[transfer full]
MMLocation3gpp * mm_modem_location_get_3gpp_sync (MMModemLocation *self,GCancellable *cancellable,GError **error);
Synchronously gets the current 3GPP location information.
The calling thread is blocked until a reply is received. See mm_modem_location_get_3gpp()
for the asynchronous version of this method.
| self | ||
| cancellable |  A GCancellable or  | [allow-none] | 
| error | Return location for error or  | 
 A MMLocation3gpp, or NULL if not available. The returned value should be freed with g_object_unref(). 
[transfer full]
void mm_modem_location_get_gps_nmea (MMModemLocation *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously gets the current GPS NMEA location information.
When the operation is finished, callback
 will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_location_get_gps_nmea_finish() to get the result of the operation.
See mm_modem_location_get_gps_nmea_sync() for the synchronous, blocking version of this method.
| self | ||
| cancellable |  A GCancellable or  | [allow-none] | 
| callback | A GAsyncReadyCallback to call when the request is satisfied or  | |
| user_data | User data to pass to  | 
MMLocationGpsNmea * mm_modem_location_get_gps_nmea_finish (MMModemLocation *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_location_get_gps_nmea().
| self | ||
| res | The GAsyncResult obtained from the GAsyncReadyCallback passed to  | |
| error | Return location for error or  | 
 A MMLocationGpsNmea, or NULL if not available. The returned value should be freed with g_object_unref(). 
[transfer full]
MMLocationGpsNmea * mm_modem_location_get_gps_nmea_sync (MMModemLocation *self,GCancellable *cancellable,GError **error);
Synchronously gets the current GPS NMEA location information.
The calling thread is blocked until a reply is received. See mm_modem_location_get_gps_nmea()
for the asynchronous version of this method.
| self | ||
| cancellable |  A GCancellable or  | [allow-none] | 
| error | Return location for error or  | 
 A MMLocationGpsNmea, or NULL if not available. The returned value should be freed with g_object_unref(). 
[transfer full]
void mm_modem_location_get_gps_raw (MMModemLocation *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously gets the current GPS raw location information.
When the operation is finished, callback
 will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_location_get_gps_raw_finish() to get the result of the operation.
See mm_modem_location_get_gps_raw_sync() for the synchronous, blocking version of this method.
| self | ||
| cancellable |  A GCancellable or  | [allow-none] | 
| callback | A GAsyncReadyCallback to call when the request is satisfied or  | |
| user_data | User data to pass to  | 
MMLocationGpsRaw * mm_modem_location_get_gps_raw_finish (MMModemLocation *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_location_get_gps_raw().
| self | ||
| res | The GAsyncResult obtained from the GAsyncReadyCallback passed to  | |
| error | Return location for error or  | 
 A MMLocationGpsRaw, or NULL if not available. The returned value should be freed with g_object_unref(). 
[transfer full]
MMLocationGpsRaw * mm_modem_location_get_gps_raw_sync (MMModemLocation *self,GCancellable *cancellable,GError **error);
Synchronously gets the current GPS raw location information.
The calling thread is blocked until a reply is received. See mm_modem_location_get_gps_raw()
for the asynchronous version of this method.
| self | ||
| cancellable |  A GCancellable or  | [allow-none] | 
| error | Return location for error or  | 
 A MMLocationGpsRaw, or NULL if not available. The returned value should be freed with g_object_unref(). 
[transfer full]
void mm_modem_location_get_cdma_bs (MMModemLocation *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously gets the current CDMA base station location information.
When the operation is finished, callback
 will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_location_get_cdma_bs_finish() to get the result of the operation.
See mm_modem_location_get_cdma_bs_sync() for the synchronous, blocking version of this method.
| self | ||
| cancellable |  A GCancellable or  | [allow-none] | 
| callback | A GAsyncReadyCallback to call when the request is satisfied or  | |
| user_data | User data to pass to  | 
MMLocationCdmaBs * mm_modem_location_get_cdma_bs_finish (MMModemLocation *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_location_get_cdma_bs().
| self | ||
| res | The GAsyncResult obtained from the GAsyncReadyCallback passed to  | |
| error | Return location for error or  | 
 A MMLocationCdmaBs, or NULL if not available. The returned value should be freed with g_object_unref(). 
[transfer full]
MMLocationCdmaBs * mm_modem_location_get_cdma_bs_sync (MMModemLocation *self,GCancellable *cancellable,GError **error);
Synchronously gets the current CDMA base station location information.
The calling thread is blocked until a reply is received. See mm_modem_location_get_cdma_bs()
for the asynchronous version of this method.
| self | ||
| cancellable |  A GCancellable or  | [allow-none] | 
| error | Return location for error or  | 
 A MMLocationCdmaBs, or NULL if not available. The returned value should be freed with g_object_unref(). 
[transfer full]
void mm_modem_location_get_full (MMModemLocation *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously gets the current location information.
When the operation is finished, callback
 will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_location_get_full_finish() to get the result of the operation.
See mm_modem_location_get_full_sync() for the synchronous, blocking version of this method.
| self | ||
| cancellable |  A GCancellable or  | [allow-none] | 
| callback | A GAsyncReadyCallback to call when the request is satisfied or  | |
| user_data | User data to pass to  | 
gboolean mm_modem_location_get_full_finish (MMModemLocation *self,GAsyncResult *res,MMLocation3gpp **location_3gpp,MMLocationGpsNmea **location_gps_nmea,MMLocationGpsRaw **location_gps_raw,MMLocationCdmaBs **location_cdma_bs,GError **error);
Finishes an operation started with mm_modem_location_get_full().
| self | ||
| location_3gpp |  Return location for a MMLocation3gpp if 3GPP location is requested, or NULL if not required. The returned value should be freed with  | [out][allow-none][transfer full] | 
| location_gps_nmea |  Return location for a MMLocationGpsNmea if GPS NMEA location is requested, or NULL if not required. The returned value should be freed with  | [out][allow-none][transfer full] | 
| location_gps_raw |  Return location for a MMLocationGpsRaw if GPS raw location is requested, or NULL if not required. The returned value should be freed with  | [out][allow-none][transfer full] | 
| location_cdma_bs |  Return location for a MMLocationCdmaBs if CDMA Base Station location is requested, or NULL if not required. The returned value should be freed with  | [out][allow-none][transfer full] | 
| res | The GAsyncResult obtained from the GAsyncReadyCallback passed to  | |
| error | Return location for error or  | 
gboolean mm_modem_location_get_full_sync (MMModemLocation *self,MMLocation3gpp **location_3gpp,MMLocationGpsNmea **location_gps_nmea,MMLocationGpsRaw **location_gps_raw,MMLocationCdmaBs **location_cdma_bs,GCancellable *cancellable,GError **error);
Synchronously gets the current location information.
The calling thread is blocked until a reply is received. See mm_modem_location_get_full()
for the asynchronous version of this method.
| self | ||
| location_3gpp |  Return location for a MMLocation3gpp if 3GPP location is requested, or NULL if not required. The returned value should be freed with  | [out][allow-none][transfer full] | 
| location_gps_nmea |  Return location for a MMLocationGpsNmea if GPS NMEA location is requested, or NULL if not required. The returned value should be freed with  | [out][allow-none][transfer full] | 
| location_gps_raw |  Return location for a MMLocationGpsRaw if GPS raw location is requested, or NULL if not required. The returned value should be freed with  | [out][allow-none][transfer full] | 
| location_cdma_bs |  Return location for a MMLocationCdmaBs if CDMA Base Station location is requested, or NULL if not required. The returned value should be freed with  | [out][allow-none][transfer full] | 
| cancellable |  A GCancellable or  | [allow-none] | 
| error | Return location for error or  | 
struct MMModemLocation;
The MMModemLocation structure contains private data and should only be accessed using the provided API.
#define MM_LOCATION_LONGITUDE_UNKNOWN G_MINDOUBLE
Identifier for an unknown longitude value.
Proper longitude values fall in the [-180,180] range.
#define MM_LOCATION_LATITUDE_UNKNOWN G_MINDOUBLE
Identifier for an unknown latitude value.
Proper latitude values fall in the [-90,90] range.