Top | ![]() |
![]() |
![]() |
![]() |
GeocluePosition contains position-related methods and signals. It is part of the Geoclue public C client API which uses D-Bus to communicate with the actual provider.
After a GeocluePosition is created with geoclue_position_new()
or
using geoclye_master_client_create_position()
, the
geoclue_position_get_position()
and geoclue_position_get_position_async()
method and the position-changed signal can be used to obtain the current position.
GeocluePosition * geoclue_position_new (const char *service
,const char *path
);
Creates a GeocluePosition with given D-Bus service name and path.
GeocluePositionFields geoclue_position_get_position (GeocluePosition *position
,int *timestamp
,double *latitude
,double *longitude
,double *altitude
,GeoclueAccuracy **accuracy
,GError **error
);
Obtains the current position. timestamp
will contain the time of
the actual position measurement. accuracy
is a rough estimate of the
accuracy of the current position.
If the caller is not interested in some values, the pointers can be
left NULL
.
position |
A GeocluePosition object |
|
timestamp |
Pointer to returned time of position measurement (Unix timestamp) or |
|
latitude |
Pointer to returned latitude in degrees or |
|
longitude |
Pointer to returned longitude in degrees or |
|
altitude |
Pointer to returned altitude in meters or |
|
accuracy |
Pointer to returned GeoclueAccuracy or |
|
error |
Pointer to returned Gerror or |
void (*GeocluePositionCallback) (GeocluePosition *position
,GeocluePositionFields fields
,int timestamp
,double latitude
,double longitude
,double altitude
,GeoclueAccuracy *accuracy
,GError *error
,gpointer userdata
);
Callback function for geoclue_position_get_position_async()
.
position |
A GeocluePosition object |
|
fields |
A GeocluePositionFields bitfield representing the validity of the position values |
|
timestamp |
Time of position measurement (Unix timestamp) |
|
latitude |
Latitude in degrees |
|
longitude |
Longitude in degrees |
|
altitude |
Altitude in meters |
|
accuracy |
Accuracy of measurement as GeoclueAccuracy |
|
error |
Error as Gerror or |
|
userdata |
User data pointer set in |
void geoclue_position_get_position_async (GeocluePosition *position
,GeocluePositionCallback callback
,gpointer userdata
);
Function returns (essentially) immediately and calls callback
when current position
is available or when D-Bus timeouts.
position |
A GeocluePosition object |
|
callback |
A GeocluePositionCallback function that should be called when return values are available |
|
userdata |
pointer for user specified data |