Geoclue Reference Manual | ||||
---|---|---|---|---|
Top | Description | Properties | Signals |
org.freedesktop.GeoClue2.Clientorg.freedesktop.GeoClue2.Client — The Application-specific client API |
Properties
Location readable o DistanceThreshold readwrite u DesktopId readwrite s RequestedAccuracyLevel readwrite u
Description
This is the interface you use to retrieve location information and receive location update signals from GeoClue service. You get the client object to use this interface on from GetClient() method.
Method Details
The Start() method
Start ();
Start receiving events about the current location. Applications should hook-up to "LocationUpdated" signal before calling this method.
Signal Details
The "LocationUpdated" signal
LocationUpdated (o old, o new);
The signal is emitted every time the location changes. The client should set the DistanceThreshold property to control how often this signal is emitted.
|
old location as path to a org.freedesktop.GeoClue2.Location object |
|
new location as path to a org.freedesktop.GeoClue2.Location object |
Property Details
The "Location" property
Location readable o
Current location as path to a org.freedesktop.GeoClue2.Location object.
The "DistanceThreshold" property
DistanceThreshold readwrite u
Contains the current distance threshold in meters. This value is used by the service when it gets new location info. If the distance moved is below the threshold, it won't emit the LocationUpdated signal.
The "DesktopId" property
DesktopId readwrite s
The desktop file id (the basename of the desktop file). This property must be set by applications for authorization to work.
The "RequestedAccuracyLevel" property
RequestedAccuracyLevel readwrite u
The level of accuracy requested by client, as GClueAccuracyLevel.
Please keep in mind that the actual accuracy of location information is dependent on available hardware on your machine, external resources and/or how much accuracy user agrees to be confortable with.