Top | ![]() |
![]() |
![]() |
![]() |
void | address-provider-changed | No Recursion |
void | invalidated | No Recursion |
void | position-provider-changed | No Recursion |
GeoclueMasterClient is part of the Geoclue public C client API. It uses D-Bus to communicate with the actual Master service.
GeoclueMasterClient is used to control the client specific behaviour of Geoclue Master. Chapter "Master provider: simple example in C" contains a more complete example, but here are the main parts:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
GeoclueMaster *master; GeoclueMasterClient *client; GeoclueAddress *address; ... master = geoclue_master_get_default (); client = geoclue_master_create_client (master, NULL, NULL); if (!geoclue_master_client_set_requirements (client, GEOCLUE_ACCURACY_LEVEL_NONE, 0, FALSE, GEOCLUE_RESOURCE_NETWORK, &error)) { / * handle error * / } address = geoclue_master_client_create_address (client, error); if (!address) { / * handle error * / } / * Now we can use address just like we'd use a normal address provider, but GeoclueMasterClient makes sure that underneath the provider that best matches our requirements is used * / |
gboolean geoclue_master_client_set_requirements (GeoclueMasterClient *client
,GeoclueAccuracyLevel min_accuracy
,int min_time
,gboolean require_updates
,GeoclueResourceFlags allowed_resources
,GError **error
);
Sets the criteria that should be used when selecting the used provider
client |
||
min_accuracy |
The required minimum accuracy as a GeoclueAccuracyLevel. |
|
min_time |
The minimum time between update signals in seconds |
|
require_updates |
Whether the updates (signals) are required. Only applies to interfaces with signals |
|
allowed_resources |
The resources that are allowed to be used as a GeoclueResourceFlags |
|
error |
void (*GeoclueSetRequirementsCallback) (GeoclueMasterClient *client
,GError *error
,gpointer userdata
);
Callback function for geoclue_master_client_set_requirements_async()
.
client |
A GeoclueMasterClient object |
|
error |
Error as Gerror (may be |
|
userdata |
User data pointer set in |
void geoclue_master_client_set_requirements_async (GeoclueMasterClient *client
,GeoclueAccuracyLevel min_accuracy
,int min_time
,gboolean require_updates
,GeoclueResourceFlags allowed_resources
,GeoclueSetRequirementsCallback callback
,gpointer userdata
);
Asynchronous version of geoclue_master_client_set_requirements()
.
client |
||
min_accuracy |
The required minimum accuracy as a GeoclueAccuracyLevel. |
|
min_time |
The minimum time between update signals (currently not implemented) |
|
require_updates |
Whether the updates (signals) are required. Only applies to interfaces with signals |
|
allowed_resources |
The resources that are allowed to be used as a GeoclueResourceFlags |
|
callback |
GeoclueSetRequirementsCallback function to call when requirements have been set |
|
userdata |
User data pointer |
GeoclueAddress * geoclue_master_client_create_address (GeoclueMasterClient *client
,GError **error
);
Starts the GeoclueMasterClient address provider and returns a GeoclueAddress that uses the same D-Bus object as the GeoclueMasterClient.
void (*CreateAddressCallback) (GeoclueMasterClient *client
,GeoclueAddress *address
,GError *error
,gpointer userdata
);
Callback function for geoclue_master_client_create_address_async()
.
client |
A GeoclueMasterClient object |
|
address |
returned GeoclueAddress |
|
error |
Error as Gerror (may be |
|
userdata |
User data pointer set in |
void geoclue_master_client_create_address_async (GeoclueMasterClient *client
,CreateAddressCallback callback
,gpointer userdata
);
Function returns (essentially) immediately and calls callback
when it has started the address provider
and a GeoclueAddress is available.
client |
A GeoclueMasterClient object |
|
callback |
A CreateAddressCallback function that should be called when return values are available |
|
userdata |
pointer for user specified data |
GeocluePosition * geoclue_master_client_create_position (GeoclueMasterClient *client
,GError **error
);
Starts the GeoclueMasterClient position provider and returns a GeocluePosition that uses the same D-Bus object as the GeoclueMasterClient.
void (*CreatePositionCallback) (GeoclueMasterClient *client
,GeocluePosition *position
,GError *error
,gpointer userdata
);
Callback function for geoclue_master_client_create_position_async()
.
client |
A GeoclueMasterClient object |
|
position |
returned GeocluePosition |
|
error |
Error as Gerror (may be |
|
userdata |
User data pointer set in |
void geoclue_master_client_create_position_async (GeoclueMasterClient *client
,CreatePositionCallback callback
,gpointer userdata
);
Function returns (essentially) immediately and calls callback
when it has started the position provider
and a GeocluePosition is available.
client |
A GeoclueMasterClient object |
|
callback |
A CreatePositionCallback function that should be called when return values are available |
|
userdata |
pointer for user specified data |
gboolean geoclue_master_client_get_address_provider (GeoclueMasterClient *client
,char **name
,char **description
,char **service
,char **path
,GError **error
);
Gets name and other information for the currently used address provider.
void (*GeoclueGetProviderCallback) (GeoclueMasterClient *client
,char *name
,char *description
,char *service
,char *path
,GError *error
,gpointer userdata
);
void geoclue_master_client_get_address_provider_async (GeoclueMasterClient *client
,GeoclueGetProviderCallback callback
,gpointer userdata
);
Gets name and other information for the currently used address provider asynchronously.
client |
||
callback |
A GeoclueGetProviderCallback function that will be called when return values are available |
|
userdata |
pointer for user specified data |
gboolean geoclue_master_client_get_position_provider (GeoclueMasterClient *client
,char **name
,char **description
,char **service
,char **path
,GError **error
);
Gets name and other information for the currently used position provider.
void geoclue_master_client_get_position_provider_async (GeoclueMasterClient *client
,GeoclueGetProviderCallback callback
,gpointer userdata
);
Gets name and other information for the currently used position provider asynchronously.
client |
||
callback |
A GeoclueGetProviderCallback function that will be called when return values are available |
|
userdata |
pointer for user specified data |
“object-path”
property“object-path” gchar *
The DBus path to the object.
Flags: Write / Construct Only
Default value: ""
“address-provider-changed”
signalvoid user_function (GeoclueMasterClient *client, gchar *name, gchar *description, gchar *service, gchar *path, gpointer user_data)
Flags: No Recursion
“invalidated”
signalvoid user_function (GeoclueMasterClient *client, gpointer user_data)
Flags: No Recursion