Abstract interface type for the D-Bus interface org.freedesktop.GeoClue2.Client``.
# Implements
[`ClientExt`][trait@crate::prelude::ClientExt]
Trait containing all [`struct@Client`] methods.
# Implementors
[`ClientProxy`][struct@crate::ClientProxy], [`Client`][struct@crate::Client]
Gets a machine-readable description of the org.freedesktop.GeoClue2.Client`` D-Bus interface.
# Returns
A [`gio::DBusInterfaceInfo`][crate::gio::DBusInterfaceInfo]. Do not free.
Overrides all `GObject` properties in the [`Client`][crate::Client] interface for a concrete class.
The properties are overridden in the order they are defined.
## `klass`
The class structure for a `GObject` derived class.
## `property_id_begin`
The property id to assign to the first overridden property.
# Returns
The last property id.
Asynchronously invokes the Start()`` D-Bus method on `self`.
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_client_call_start_finish()` to get the result of the operation.
See [`call_start_sync()`][Self::call_start_sync()] for the synchronous, blocking version of this method.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied or [`None`].
Finishes an operation started with [`call_start()`][Self::call_start()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`call_start()`][Self::call_start()].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
Synchronously invokes the Start()`` D-Bus method on `self`. The calling thread is blocked until a reply is received.
See [`call_start()`][Self::call_start()] for the asynchronous version of this method.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
Asynchronously invokes the Stop()`` D-Bus method on `self`.
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_client_call_stop_finish()` to get the result of the operation.
See [`call_stop_sync()`][Self::call_stop_sync()] for the synchronous, blocking version of this method.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied or [`None`].
Finishes an operation started with [`call_stop()`][Self::call_stop()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`call_stop()`][Self::call_stop()].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
Synchronously invokes the Stop()`` D-Bus method on `self`. The calling thread is blocked until a reply is received.
See [`call_stop()`][Self::call_stop()] for the asynchronous version of this method.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
Helper function used in service implementations to finish handling invocations of the Start()`` D-Bus method. If you instead want to finish handling an invocation by returning an error, use [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] or similar.
This method will free `invocation`, you cannot use it afterwards.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
Helper function used in service implementations to finish handling invocations of the Stop()`` D-Bus method. If you instead want to finish handling an invocation by returning an error, use [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] or similar.
This method will free `invocation`, you cannot use it afterwards.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
Gets a copy of the "DesktopId"`` D-Bus property.
Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value or [`None`] if the property is not set. The returned value should be freed with `g_free()`.
Gets a copy of the "Location"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value or [`None`] if the property is not set. The returned value should be freed with `g_free()`.
Emits the "LocationUpdated"`` D-Bus signal.
## `arg_old`
Argument to pass with the signal.
## `arg_new`
Argument to pass with the signal.
Gets the value of the "Active"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "DesktopId"`` D-Bus property.
Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where `self` was constructed. Use [`dup_desktop_id()`][Self::dup_desktop_id()] if on another thread.
# Returns
The property value or [`None`] if the property is not set. Do not free the returned value, it belongs to `self`.
Gets the value of the "DistanceThreshold"`` D-Bus property.
Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "Location"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where `self` was constructed. Use [`dup_location()`][Self::dup_location()] if on another thread.
# Returns
The property value or [`None`] if the property is not set. Do not free the returned value, it belongs to `self`.
Gets the value of the "RequestedAccuracyLevel"`` D-Bus property.
Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "TimeThreshold"`` D-Bus property.
Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Sets the "Active"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "DesktopId"`` D-Bus property to `value`.
Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
## `value`
The value to set.
Sets the "DistanceThreshold"`` D-Bus property to `value`.
Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
## `value`
The value to set.
Sets the "Location"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "RequestedAccuracyLevel"`` D-Bus property to `value`.
Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
## `value`
The value to set.
Sets the "TimeThreshold"`` D-Bus property to `value`.
Since this D-Bus property is both readable and writable, it is meaningful to use this function on both the client- and service-side.
## `value`
The value to set.
Signal emitted when a remote caller is invoking the Start()`` D-Bus method.
If a signal handler returns [`true`], it means the signal handler will handle the invocation (e.g. take a reference to `invocation` and eventually call [`complete_start()`][Self::complete_start()] or e.g. [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] on it) and no order signal handlers will run. If no signal handler handles the invocation, the `G_DBUS_ERROR_UNKNOWN_METHOD` error is returned.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
# Returns
`G_DBUS_METHOD_INVOCATION_HANDLED` or [`true`] if the invocation was handled, `G_DBUS_METHOD_INVOCATION_UNHANDLED` or [`false`] to let other signal handlers run.
Signal emitted when a remote caller is invoking the Stop()`` D-Bus method.
If a signal handler returns [`true`], it means the signal handler will handle the invocation (e.g. take a reference to `invocation` and eventually call [`complete_stop()`][Self::complete_stop()] or e.g. [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] on it) and no order signal handlers will run. If no signal handler handles the invocation, the `G_DBUS_ERROR_UNKNOWN_METHOD` error is returned.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
# Returns
`G_DBUS_METHOD_INVOCATION_HANDLED` or [`true`] if the invocation was handled, `G_DBUS_METHOD_INVOCATION_UNHANDLED` or [`false`] to let other signal handlers run.
On the client-side, this signal is emitted whenever the D-Bus signal "LocationUpdated"`` is received.
On the service-side, this signal can be used with e.g. `g_signal_emit_by_name()` to make the object emit the D-Bus signal.
## `arg_old`
Argument.
## `arg_new`
Argument.
Represents the D-Bus property "Active"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
The [`ClientProxy`][crate::ClientProxy] structure contains only private data and should only be accessed using the provided API.
# Implements
[`ClientExt`][trait@crate::prelude::ClientExt]
If this property is not [`gio::BusType::None`][crate::gio::BusType::None], then
`GDBusProxy:g-connection` must be [`None`] and will be set to the
[`gio::DBusConnection`][crate::gio::DBusConnection] obtained by calling `g_bus_get()` with the value
of this property.
The [`gio::DBusConnection`][crate::gio::DBusConnection] the proxy is for.
The timeout to use if -1 (specifying default timeout) is passed
as `timeout_msec` in the `g_dbus_proxy_call()` and
`g_dbus_proxy_call_sync()` functions.
This allows applications to set a proxy-wide timeout for all
remote method invocations on the proxy. If this property is -1,
the default timeout (typically 25 seconds) is used. If set to
`G_MAXINT`, then no timeout is used.
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
Ensure that interactions with this proxy conform to the given
interface. This is mainly to ensure that malformed data received
from the other peer is ignored. The given [`gio::DBusInterfaceInfo`][crate::gio::DBusInterfaceInfo] is
said to be the "expected interface".
The checks performed are:
- When completing a method call, if the type signature of
the reply message isn't what's expected, the reply is
discarded and the [`glib::Error`][crate::glib::Error] is set to `G_IO_ERROR_INVALID_ARGUMENT`.
- Received signals that have a type signature mismatch are dropped and
a warning is logged via `g_warning()`.
- Properties received via the initial `GetAll()` call or via the
`::PropertiesChanged` signal (on the
[org.freedesktop.DBus.Properties](http://dbus.freedesktop.org/doc/dbus-specification.html`standard`-interfaces-properties)
interface) or set using `g_dbus_proxy_set_cached_property()`
with a type signature mismatch are ignored and a warning is
logged via `g_warning()`.
Note that these checks are never done on methods, signals and
properties that are not referenced in the given
[`gio::DBusInterfaceInfo`][crate::gio::DBusInterfaceInfo], since extending a D-Bus interface on the
service-side is not considered an ABI break.
The D-Bus interface name the proxy is for.
The well-known or unique name that the proxy is for.
The unique name that owns `GDBusProxy:g-name` or [`None`] if no-one
currently owns that name. You may connect to `GObject::notify` signal to
track changes to this property.
The object path the proxy is for.
Represents the D-Bus property "Active"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "DesktopId"``.
Since the D-Bus property for this `GObject` property is both readable and writable, it is meaningful to both read from it and write to it on both the service- and client-side.
Represents the D-Bus property "DistanceThreshold"``.
Since the D-Bus property for this `GObject` property is both readable and writable, it is meaningful to both read from it and write to it on both the service- and client-side.
Represents the D-Bus property "Location"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "RequestedAccuracyLevel"``.
Since the D-Bus property for this `GObject` property is both readable and writable, it is meaningful to both read from it and write to it on both the service- and client-side.
Represents the D-Bus property "TimeThreshold"``.
Since the D-Bus property for this `GObject` property is both readable and writable, it is meaningful to both read from it and write to it on both the service- and client-side.
Finishes an operation started with [`new()`][Self::new()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`new()`][Self::new()].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Finishes an operation started with [`new_for_bus()`][Self::new_for_bus()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`new_for_bus()`][Self::new_for_bus()].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Like [`new_sync()`][Self::new_sync()] but takes a [`gio::BusType`][crate::gio::BusType] instead of a [`gio::DBusConnection`][crate::gio::DBusConnection].
The calling thread is blocked until a reply is received.
See [`new_for_bus()`][Self::new_for_bus()] for the asynchronous version of this constructor.
## `bus_type`
A [`gio::BusType`][crate::gio::BusType].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique).
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Synchronously creates a proxy for the D-Bus interface org.freedesktop.GeoClue2.Client``. See `g_dbus_proxy_new_sync()` for more details.
The calling thread is blocked until a reply is received.
See [`new()`][Self::new()] for the asynchronous version of this constructor.
## `connection`
A [`gio::DBusConnection`][crate::gio::DBusConnection].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique) or [`None`] if `connection` is not a message bus connection.
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
The constructed proxy object or [`None`] if `error` is set.
A utility function to create a [`ClientProxy`][crate::ClientProxy] without having to deal with
a [`Manager`][crate::Manager]. See also [`create_full()`][Self::create_full()] which improves
resource management.
This is identitcal to calling [`create_full()`][Self::create_full()] without any
flags set.
See [`create_sync()`][Self::create_sync()] for the synchronous, blocking version
of this function.
## `desktop_id`
The desktop file id (the basename of the desktop file).
## `accuracy_level`
The requested accuracy level as [`AccuracyLevel`][crate::AccuracyLevel].
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the results are ready.
Finishes an operation started with [`create()`][Self::create()].
## `result`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to
[`create()`][Self::create()].
# Returns
The constructed proxy
object or [`None`] if `error` is set.
A utility function to create a [`ClientProxy`][crate::ClientProxy] without having to deal with
a [`Manager`][crate::Manager].
By setting the [`ClientProxyCreateFlags::AUTO_DELETE`][crate::ClientProxyCreateFlags::AUTO_DELETE] flag you can ensure
that the client will be deleted again from the geoclue service when
it is destroyed. This flag should be used unless you are doing explicit
resource management.
See [`create_full_sync()`][Self::create_full_sync()] for the synchronous, blocking
version of this function.
## `desktop_id`
The desktop file id (the basename of the desktop file).
## `accuracy_level`
The requested accuracy level as [`AccuracyLevel`][crate::AccuracyLevel].
## `flags`
[`ClientProxyCreateFlags`][crate::ClientProxyCreateFlags] to modify the creation.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the results are ready.
Finishes an operation started with [`create_full()`][Self::create_full()].
## `result`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to
[`create()`][Self::create()].
# Returns
The constructed proxy
object or [`None`] if `error` is set.
The synchronous and blocking version of [`create_full()`][Self::create_full()].
By setting the [`ClientProxyCreateFlags::AUTO_DELETE`][crate::ClientProxyCreateFlags::AUTO_DELETE] flag you can ensure
that the client will be deleted again from the geoclue service when
it is destroyed. This flag should be used unless you are doing explicit
resource management.
## `desktop_id`
The desktop file id (the basename of the desktop file).
## `accuracy_level`
The requested accuracy level as [`AccuracyLevel`][crate::AccuracyLevel].
## `flags`
[`ClientProxyCreateFlags`][crate::ClientProxyCreateFlags] to modify the creation.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
The constructed proxy
object or [`None`] if `error` is set.
The synchronous and blocking version of [`create()`][Self::create()].
See also [`create_full_sync()`][Self::create_full_sync()] which improves resource
management.
This function is identical to calling [`create_full_sync()`][Self::create_full_sync()]
without any flags set.
## `desktop_id`
The desktop file id (the basename of the desktop file).
## `accuracy_level`
The requested accuracy level as [`AccuracyLevel`][crate::AccuracyLevel].
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
The constructed proxy
object or [`None`] if `error` is set.
Asynchronously creates a proxy for the D-Bus interface org.freedesktop.GeoClue2.Client``. See `g_dbus_proxy_new()` for more details.
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_client_proxy_new_finish()` to get the result of the operation.
See [`new_sync()`][Self::new_sync()] for the synchronous, blocking version of this constructor.
## `connection`
A [`gio::DBusConnection`][crate::gio::DBusConnection].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique) or [`None`] if `connection` is not a message bus connection.
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied.
Like [`new()`][Self::new()] but takes a [`gio::BusType`][crate::gio::BusType] instead of a [`gio::DBusConnection`][crate::gio::DBusConnection].
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_client_proxy_new_for_bus_finish()` to get the result of the operation.
See [`for_bus_sync()`][Self::for_bus_sync()] for the synchronous, blocking version of this constructor.
## `bus_type`
A [`gio::BusType`][crate::gio::BusType].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique).
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied.
Abstract interface type for the D-Bus interface org.freedesktop.GeoClue2.Location``.
# Implements
[`LocationExt`][trait@crate::prelude::LocationExt]
Trait containing all [`struct@Location`] methods.
# Implementors
[`LocationProxy`][struct@crate::LocationProxy], [`LocationSkeleton`][struct@crate::LocationSkeleton], [`Location`][struct@crate::Location]
Gets a machine-readable description of the org.freedesktop.GeoClue2.Location`` D-Bus interface.
# Returns
A [`gio::DBusInterfaceInfo`][crate::gio::DBusInterfaceInfo]. Do not free.
Overrides all `GObject` properties in the [`Location`][crate::Location] interface for a concrete class.
The properties are overridden in the order they are defined.
## `klass`
The class structure for a `GObject` derived class.
## `property_id_begin`
The property id to assign to the first overridden property.
# Returns
The last property id.
Gets a copy of the "Description"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value or [`None`] if the property is not set. The returned value should be freed with `g_free()`.
Gets a copy of the "Timestamp"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value or [`None`] if the property is not set. The returned value should be freed with `g_variant_unref()`.
Gets the value of the "Accuracy"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "Altitude"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "Description"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where `self` was constructed. Use [`dup_description()`][Self::dup_description()] if on another thread.
# Returns
The property value or [`None`] if the property is not set. Do not free the returned value, it belongs to `self`.
Gets the value of the "Heading"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "Latitude"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "Longitude"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "Speed"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "Timestamp"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where `self` was constructed. Use [`dup_timestamp()`][Self::dup_timestamp()] if on another thread.
# Returns
The property value or [`None`] if the property is not set. Do not free the returned value, it belongs to `self`.
Sets the "Accuracy"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "Altitude"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "Description"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "Heading"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "Latitude"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "Longitude"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "Speed"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "Timestamp"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
The [`LocationProxy`][crate::LocationProxy] structure contains only private data and should only be accessed using the provided API.
# Implements
[`LocationExt`][trait@crate::prelude::LocationExt]
If this property is not [`gio::BusType::None`][crate::gio::BusType::None], then
`GDBusProxy:g-connection` must be [`None`] and will be set to the
[`gio::DBusConnection`][crate::gio::DBusConnection] obtained by calling `g_bus_get()` with the value
of this property.
The [`gio::DBusConnection`][crate::gio::DBusConnection] the proxy is for.
The timeout to use if -1 (specifying default timeout) is passed
as `timeout_msec` in the `g_dbus_proxy_call()` and
`g_dbus_proxy_call_sync()` functions.
This allows applications to set a proxy-wide timeout for all
remote method invocations on the proxy. If this property is -1,
the default timeout (typically 25 seconds) is used. If set to
`G_MAXINT`, then no timeout is used.
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
Ensure that interactions with this proxy conform to the given
interface. This is mainly to ensure that malformed data received
from the other peer is ignored. The given [`gio::DBusInterfaceInfo`][crate::gio::DBusInterfaceInfo] is
said to be the "expected interface".
The checks performed are:
- When completing a method call, if the type signature of
the reply message isn't what's expected, the reply is
discarded and the [`glib::Error`][crate::glib::Error] is set to `G_IO_ERROR_INVALID_ARGUMENT`.
- Received signals that have a type signature mismatch are dropped and
a warning is logged via `g_warning()`.
- Properties received via the initial `GetAll()` call or via the
`::PropertiesChanged` signal (on the
[org.freedesktop.DBus.Properties](http://dbus.freedesktop.org/doc/dbus-specification.html`standard`-interfaces-properties)
interface) or set using `g_dbus_proxy_set_cached_property()`
with a type signature mismatch are ignored and a warning is
logged via `g_warning()`.
Note that these checks are never done on methods, signals and
properties that are not referenced in the given
[`gio::DBusInterfaceInfo`][crate::gio::DBusInterfaceInfo], since extending a D-Bus interface on the
service-side is not considered an ABI break.
The D-Bus interface name the proxy is for.
The well-known or unique name that the proxy is for.
The unique name that owns `GDBusProxy:g-name` or [`None`] if no-one
currently owns that name. You may connect to `GObject::notify` signal to
track changes to this property.
The object path the proxy is for.
Represents the D-Bus property "Accuracy"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Altitude"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Description"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Heading"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Latitude"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Longitude"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Speed"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Timestamp"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Finishes an operation started with [`new()`][Self::new()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`new()`][Self::new()].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Finishes an operation started with [`new_for_bus()`][Self::new_for_bus()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`new_for_bus()`][Self::new_for_bus()].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Like [`new_sync()`][Self::new_sync()] but takes a [`gio::BusType`][crate::gio::BusType] instead of a [`gio::DBusConnection`][crate::gio::DBusConnection].
The calling thread is blocked until a reply is received.
See [`new_for_bus()`][Self::new_for_bus()] for the asynchronous version of this constructor.
## `bus_type`
A [`gio::BusType`][crate::gio::BusType].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique).
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Synchronously creates a proxy for the D-Bus interface org.freedesktop.GeoClue2.Location``. See `g_dbus_proxy_new_sync()` for more details.
The calling thread is blocked until a reply is received.
See [`new()`][Self::new()] for the asynchronous version of this constructor.
## `connection`
A [`gio::DBusConnection`][crate::gio::DBusConnection].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique) or [`None`] if `connection` is not a message bus connection.
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Asynchronously creates a proxy for the D-Bus interface org.freedesktop.GeoClue2.Location``. See `g_dbus_proxy_new()` for more details.
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_location_proxy_new_finish()` to get the result of the operation.
See [`new_sync()`][Self::new_sync()] for the synchronous, blocking version of this constructor.
## `connection`
A [`gio::DBusConnection`][crate::gio::DBusConnection].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique) or [`None`] if `connection` is not a message bus connection.
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied.
Like [`new()`][Self::new()] but takes a [`gio::BusType`][crate::gio::BusType] instead of a [`gio::DBusConnection`][crate::gio::DBusConnection].
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_location_proxy_new_for_bus_finish()` to get the result of the operation.
See [`for_bus_sync()`][Self::for_bus_sync()] for the synchronous, blocking version of this constructor.
## `bus_type`
A [`gio::BusType`][crate::gio::BusType].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique).
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied.
The [`LocationSkeleton`][crate::LocationSkeleton] structure contains only private data and should only be accessed using the provided API.
# Implements
[`LocationExt`][trait@crate::prelude::LocationExt]
Flags from the `GDBusInterfaceSkeletonFlags` enumeration.
Represents the D-Bus property "Accuracy"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Altitude"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Description"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Heading"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Latitude"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Longitude"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Speed"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "Timestamp"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Creates a skeleton object for the D-Bus interface org.freedesktop.GeoClue2.Location``.
# Returns
The skeleton object.
Abstract interface type for the D-Bus interface org.freedesktop.GeoClue2.Manager``.
# Implements
[`ManagerExt`][trait@crate::prelude::ManagerExt]
Trait containing all [`struct@Manager`] methods.
# Implementors
[`ManagerProxy`][struct@crate::ManagerProxy], [`ManagerSkeleton`][struct@crate::ManagerSkeleton], [`Manager`][struct@crate::Manager]
Gets a machine-readable description of the org.freedesktop.GeoClue2.Manager`` D-Bus interface.
# Returns
A [`gio::DBusInterfaceInfo`][crate::gio::DBusInterfaceInfo]. Do not free.
Overrides all `GObject` properties in the [`Manager`][crate::Manager] interface for a concrete class.
The properties are overridden in the order they are defined.
## `klass`
The class structure for a `GObject` derived class.
## `property_id_begin`
The property id to assign to the first overridden property.
# Returns
The last property id.
Asynchronously invokes the AddAgent()`` D-Bus method on `self`.
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_manager_call_add_agent_finish()` to get the result of the operation.
See [`call_add_agent_sync()`][Self::call_add_agent_sync()] for the synchronous, blocking version of this method.
## `arg_id`
Argument to pass with the method invocation.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied or [`None`].
Finishes an operation started with [`call_add_agent()`][Self::call_add_agent()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`call_add_agent()`][Self::call_add_agent()].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
Synchronously invokes the AddAgent()`` D-Bus method on `self`. The calling thread is blocked until a reply is received.
See [`call_add_agent()`][Self::call_add_agent()] for the asynchronous version of this method.
## `arg_id`
Argument to pass with the method invocation.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
Asynchronously invokes the CreateClient()`` D-Bus method on `self`.
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_manager_call_create_client_finish()` to get the result of the operation.
See [`call_create_client_sync()`][Self::call_create_client_sync()] for the synchronous, blocking version of this method.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied or [`None`].
Finishes an operation started with [`call_create_client()`][Self::call_create_client()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`call_create_client()`][Self::call_create_client()].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
## `out_client`
Return location for return parameter or [`None`] to ignore.
Synchronously invokes the CreateClient()`` D-Bus method on `self`. The calling thread is blocked until a reply is received.
See [`call_create_client()`][Self::call_create_client()] for the asynchronous version of this method.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
## `out_client`
Return location for return parameter or [`None`] to ignore.
Asynchronously invokes the DeleteClient()`` D-Bus method on `self`.
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_manager_call_delete_client_finish()` to get the result of the operation.
See [`call_delete_client_sync()`][Self::call_delete_client_sync()] for the synchronous, blocking version of this method.
## `arg_client`
Argument to pass with the method invocation.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied or [`None`].
Finishes an operation started with [`call_delete_client()`][Self::call_delete_client()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`call_delete_client()`][Self::call_delete_client()].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
Synchronously invokes the DeleteClient()`` D-Bus method on `self`. The calling thread is blocked until a reply is received.
See [`call_delete_client()`][Self::call_delete_client()] for the asynchronous version of this method.
## `arg_client`
Argument to pass with the method invocation.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
Asynchronously invokes the GetClient()`` D-Bus method on `self`.
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_manager_call_get_client_finish()` to get the result of the operation.
See [`call_get_client_sync()`][Self::call_get_client_sync()] for the synchronous, blocking version of this method.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied or [`None`].
Finishes an operation started with [`call_get_client()`][Self::call_get_client()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`call_get_client()`][Self::call_get_client()].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
## `out_client`
Return location for return parameter or [`None`] to ignore.
Synchronously invokes the GetClient()`` D-Bus method on `self`. The calling thread is blocked until a reply is received.
See [`call_get_client()`][Self::call_get_client()] for the asynchronous version of this method.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
[`true`] if the call succeeded, [`false`] if `error` is set.
## `out_client`
Return location for return parameter or [`None`] to ignore.
Helper function used in service implementations to finish handling invocations of the AddAgent()`` D-Bus method. If you instead want to finish handling an invocation by returning an error, use [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] or similar.
This method will free `invocation`, you cannot use it afterwards.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
Helper function used in service implementations to finish handling invocations of the CreateClient()`` D-Bus method. If you instead want to finish handling an invocation by returning an error, use [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] or similar.
This method will free `invocation`, you cannot use it afterwards.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
## `client`
Parameter to return.
Helper function used in service implementations to finish handling invocations of the DeleteClient()`` D-Bus method. If you instead want to finish handling an invocation by returning an error, use [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] or similar.
This method will free `invocation`, you cannot use it afterwards.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
Helper function used in service implementations to finish handling invocations of the GetClient()`` D-Bus method. If you instead want to finish handling an invocation by returning an error, use [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] or similar.
This method will free `invocation`, you cannot use it afterwards.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
## `client`
Parameter to return.
Gets the value of the "AvailableAccuracyLevel"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Gets the value of the "InUse"`` D-Bus property.
Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
# Returns
The property value.
Sets the "AvailableAccuracyLevel"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Sets the "InUse"`` D-Bus property to `value`.
Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
## `value`
The value to set.
Signal emitted when a remote caller is invoking the AddAgent()`` D-Bus method.
If a signal handler returns [`true`], it means the signal handler will handle the invocation (e.g. take a reference to `invocation` and eventually call [`complete_add_agent()`][Self::complete_add_agent()] or e.g. [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] on it) and no order signal handlers will run. If no signal handler handles the invocation, the `G_DBUS_ERROR_UNKNOWN_METHOD` error is returned.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
## `arg_id`
Argument passed by remote caller.
# Returns
`G_DBUS_METHOD_INVOCATION_HANDLED` or [`true`] if the invocation was handled, `G_DBUS_METHOD_INVOCATION_UNHANDLED` or [`false`] to let other signal handlers run.
Signal emitted when a remote caller is invoking the CreateClient()`` D-Bus method.
If a signal handler returns [`true`], it means the signal handler will handle the invocation (e.g. take a reference to `invocation` and eventually call [`complete_create_client()`][Self::complete_create_client()] or e.g. [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] on it) and no order signal handlers will run. If no signal handler handles the invocation, the `G_DBUS_ERROR_UNKNOWN_METHOD` error is returned.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
# Returns
`G_DBUS_METHOD_INVOCATION_HANDLED` or [`true`] if the invocation was handled, `G_DBUS_METHOD_INVOCATION_UNHANDLED` or [`false`] to let other signal handlers run.
Signal emitted when a remote caller is invoking the DeleteClient()`` D-Bus method.
If a signal handler returns [`true`], it means the signal handler will handle the invocation (e.g. take a reference to `invocation` and eventually call [`complete_delete_client()`][Self::complete_delete_client()] or e.g. [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] on it) and no order signal handlers will run. If no signal handler handles the invocation, the `G_DBUS_ERROR_UNKNOWN_METHOD` error is returned.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
## `arg_client`
Argument passed by remote caller.
# Returns
`G_DBUS_METHOD_INVOCATION_HANDLED` or [`true`] if the invocation was handled, `G_DBUS_METHOD_INVOCATION_UNHANDLED` or [`false`] to let other signal handlers run.
Signal emitted when a remote caller is invoking the GetClient()`` D-Bus method.
If a signal handler returns [`true`], it means the signal handler will handle the invocation (e.g. take a reference to `invocation` and eventually call [`complete_get_client()`][Self::complete_get_client()] or e.g. [`DBusMethodInvocation::return_error()`][crate::gio::DBusMethodInvocation::return_error()] on it) and no order signal handlers will run. If no signal handler handles the invocation, the `G_DBUS_ERROR_UNKNOWN_METHOD` error is returned.
## `invocation`
A [`gio::DBusMethodInvocation`][crate::gio::DBusMethodInvocation].
# Returns
`G_DBUS_METHOD_INVOCATION_HANDLED` or [`true`] if the invocation was handled, `G_DBUS_METHOD_INVOCATION_UNHANDLED` or [`false`] to let other signal handlers run.
Represents the D-Bus property "InUse"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
The [`ManagerProxy`][crate::ManagerProxy] structure contains only private data and should only be accessed using the provided API.
# Implements
[`ManagerExt`][trait@crate::prelude::ManagerExt]
If this property is not [`gio::BusType::None`][crate::gio::BusType::None], then
`GDBusProxy:g-connection` must be [`None`] and will be set to the
[`gio::DBusConnection`][crate::gio::DBusConnection] obtained by calling `g_bus_get()` with the value
of this property.
The [`gio::DBusConnection`][crate::gio::DBusConnection] the proxy is for.
The timeout to use if -1 (specifying default timeout) is passed
as `timeout_msec` in the `g_dbus_proxy_call()` and
`g_dbus_proxy_call_sync()` functions.
This allows applications to set a proxy-wide timeout for all
remote method invocations on the proxy. If this property is -1,
the default timeout (typically 25 seconds) is used. If set to
`G_MAXINT`, then no timeout is used.
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
Ensure that interactions with this proxy conform to the given
interface. This is mainly to ensure that malformed data received
from the other peer is ignored. The given [`gio::DBusInterfaceInfo`][crate::gio::DBusInterfaceInfo] is
said to be the "expected interface".
The checks performed are:
- When completing a method call, if the type signature of
the reply message isn't what's expected, the reply is
discarded and the [`glib::Error`][crate::glib::Error] is set to `G_IO_ERROR_INVALID_ARGUMENT`.
- Received signals that have a type signature mismatch are dropped and
a warning is logged via `g_warning()`.
- Properties received via the initial `GetAll()` call or via the
`::PropertiesChanged` signal (on the
[org.freedesktop.DBus.Properties](http://dbus.freedesktop.org/doc/dbus-specification.html`standard`-interfaces-properties)
interface) or set using `g_dbus_proxy_set_cached_property()`
with a type signature mismatch are ignored and a warning is
logged via `g_warning()`.
Note that these checks are never done on methods, signals and
properties that are not referenced in the given
[`gio::DBusInterfaceInfo`][crate::gio::DBusInterfaceInfo], since extending a D-Bus interface on the
service-side is not considered an ABI break.
The D-Bus interface name the proxy is for.
The well-known or unique name that the proxy is for.
The unique name that owns `GDBusProxy:g-name` or [`None`] if no-one
currently owns that name. You may connect to `GObject::notify` signal to
track changes to this property.
The object path the proxy is for.
Represents the D-Bus property "AvailableAccuracyLevel"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "InUse"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Finishes an operation started with [`new()`][Self::new()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`new()`][Self::new()].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Finishes an operation started with [`new_for_bus()`][Self::new_for_bus()].
## `res`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to [`new_for_bus()`][Self::new_for_bus()].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Like [`new_sync()`][Self::new_sync()] but takes a [`gio::BusType`][crate::gio::BusType] instead of a [`gio::DBusConnection`][crate::gio::DBusConnection].
The calling thread is blocked until a reply is received.
See [`new_for_bus()`][Self::new_for_bus()] for the asynchronous version of this constructor.
## `bus_type`
A [`gio::BusType`][crate::gio::BusType].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique).
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Synchronously creates a proxy for the D-Bus interface org.freedesktop.GeoClue2.Manager``. See `g_dbus_proxy_new_sync()` for more details.
The calling thread is blocked until a reply is received.
See [`new()`][Self::new()] for the asynchronous version of this constructor.
## `connection`
A [`gio::DBusConnection`][crate::gio::DBusConnection].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique) or [`None`] if `connection` is not a message bus connection.
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
The constructed proxy object or [`None`] if `error` is set.
Asynchronously creates a proxy for the D-Bus interface org.freedesktop.GeoClue2.Manager``. See `g_dbus_proxy_new()` for more details.
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_manager_proxy_new_finish()` to get the result of the operation.
See [`new_sync()`][Self::new_sync()] for the synchronous, blocking version of this constructor.
## `connection`
A [`gio::DBusConnection`][crate::gio::DBusConnection].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique) or [`None`] if `connection` is not a message bus connection.
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied.
Like [`new()`][Self::new()] but takes a [`gio::BusType`][crate::gio::BusType] instead of a [`gio::DBusConnection`][crate::gio::DBusConnection].
When the operation is finished, `callback` will be invoked in the thread-default main loop of the thread you are calling this method from (see `g_main_context_push_thread_default()`).
You can then call `gclue_manager_proxy_new_for_bus_finish()` to get the result of the operation.
See [`for_bus_sync()`][Self::for_bus_sync()] for the synchronous, blocking version of this constructor.
## `bus_type`
A [`gio::BusType`][crate::gio::BusType].
## `flags`
Flags from the [`gio::DBusProxyFlags`][crate::gio::DBusProxyFlags] enumeration.
## `name`
A bus name (well-known or unique).
## `object_path`
An object path.
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the request is satisfied.
The [`ManagerSkeleton`][crate::ManagerSkeleton] structure contains only private data and should only be accessed using the provided API.
# Implements
[`ManagerExt`][trait@crate::prelude::ManagerExt]
Flags from the `GDBusInterfaceSkeletonFlags` enumeration.
Represents the D-Bus property "AvailableAccuracyLevel"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Represents the D-Bus property "InUse"``.
Since the D-Bus property for this `GObject` property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.
Creates a skeleton object for the D-Bus interface org.freedesktop.GeoClue2.Manager``.
# Returns
The skeleton object.
# Implements
[`SimpleExt`][trait@crate::prelude::SimpleExt]
The requested maximum accuracy level.
The client proxy.
The Desktop ID of the application.
The current location.
Trait containing all [`struct@Simple`] methods.
# Implementors
[`Simple`][struct@crate::Simple]
Finishes an operation started with [`new()`][Self::new()].
## `result`
The [`gio::AsyncResult`][crate::gio::AsyncResult] obtained from the `GAsyncReadyCallback` passed to
[`new()`][Self::new()].
# Returns
The constructed proxy
object or [`None`] if `error` is set.
The synchronous and blocking version of [`new()`][Self::new()].
## `desktop_id`
The desktop file id (the basename of the desktop file).
## `accuracy_level`
The requested accuracy level as [`AccuracyLevel`][crate::AccuracyLevel].
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
# Returns
The new [`Simple`][crate::Simple] object or
[`None`] if `error` is set.
Asynchronously creates a [`Simple`][crate::Simple] instance. Use
`gclue_simple_new_finish()` to get the created [`Simple`][crate::Simple] instance.
See [`new_sync()`][Self::new_sync()] for the synchronous, blocking version
of this function.
## `desktop_id`
The desktop file id (the basename of the desktop file).
## `accuracy_level`
The requested accuracy level as [`AccuracyLevel`][crate::AccuracyLevel].
## `cancellable`
A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
## `callback`
A `GAsyncReadyCallback` to call when the results are ready.
Gets the client proxy.
# Returns
The client object.
Gets the current location.
# Returns
The last known location
as [`Location`][crate::Location].
The requested maximum accuracy level.
The Desktop ID of the application.