The Setup() method

Setup (IN  u sources,
       IN  b signal_location);

Configure the location sources to use when gathering location information. Also enable or disable location information gathering. This method may require the client to authenticate itself.

When signals are emitted, any client application (including malicious ones!) can listen for location updates unless D-Bus permissions restrict these signals from certain users. If further security is desired, the signal_location argument can be set to FALSE to disable location updates via D-Bus signals and require applications to call authenticated APIs (like GetLocation() ) to get location information.

The optional MM_MODEM_LOCATION_SOURCE_AGPS_MSA and MM_MODEM_LOCATION_SOURCE_AGPS_MSB allow to request MSA/MSB A-GPS operation, and they must be given along with either MM_MODEM_LOCATION_SOURCE_GPS_RAW or MM_MODEM_LOCATION_SOURCE_GPS_NMEA.

Both MM_MODEM_LOCATION_SOURCE_AGPS_MSA and MM_MODEM_LOCATION_SOURCE_AGPS_MSB cannot be given at the same time, and if none given, standalone GPS is assumed.

The GetLocation() method

GetLocation (OUT a{uv} Location);

Return current location information, if any. If the modem supports multiple location types it may return more than one. See the "Location" property for more information on the dictionary returned at location.

This method may require the client to authenticate itself.

The SetSuplServer() method

SetSuplServer (IN  s supl);

Configure the SUPL server for A-GPS.

The InjectAssistanceData() method

InjectAssistanceData (IN  ay data);

Inject assistance data to the GNSS module. The data files should be downloaded using external means from the URLs specified in the AssistanceDataServers property.

The user does not need to specify the assistance data type being given.

There is no maximum data size limit specified, default DBus system bus limits apply.

The SetGpsRefreshRate() method

SetGpsRefreshRate (IN  u rate);

Set the refresh rate of the GPS information in the API. If not explicitly set, a default of 30s will be used.

The refresh rate can be set to 0 to disable it, so that every update reported by the modem is published in the interface.

The "Capabilities" property

Capabilities  readable   u

Bitmask of MMModemLocationSource values, specifying the supported location sources.

The "SupportedAssistanceData" property

SupportedAssistanceData  readable   u

Bitmask of MMModemLocationAssistanceDataType values, specifying the supported types of assistance data.

The "Enabled" property

Enabled  readable   u

Bitmask specifying which of the supported MMModemLocationSource location sources is currently enabled in the device.

The "SignalsLocation" property

SignalsLocation  readable   b

TRUE if location updates will be emitted via D-Bus signals, FALSE if location updates will not be emitted.

See the Setup() method for more information.

The "Location" property

Location  readable   a{uv}

Dictionary of available location information when location information gathering is enabled. If the modem supports multiple location types it may return more than one here.

Note that if the device was told not to emit updated location information when location information gathering was initially enabled, this property may not return any location information for security reasons.

This dictionary is composed of a MMModemLocationSource key, with an associated data which contains type-specific location information:

The "SuplServer" property

SuplServer  readable   s

SUPL server configuration for A-GPS, given either as IP:PORT or FQDN:PORT.

The "AssistanceDataServers" property

AssistanceDataServers  readable   as

URLs from where the user can download assistance data files to inject with InjectAssistanceData().

The "GpsRefreshRate" property

GpsRefreshRate  readable   u

Rate of refresh of the GPS information in the interface.