Top |
WebKitGeolocationManager provides API to get the geographical position of the user.
Once a WebKitGeolocationPermissionRequest is allowed, when WebKit needs to know the
user location “start” signal is emitted. If the signal is handled
and returns TRUE
, the application is responsible for providing the position every time it's
updated by calling webkit_geolocation_manager_update_position()
. The signal “stop”
will be emitted when location updates are no longer needed.
void webkit_geolocation_manager_update_position (WebKitGeolocationManager *manager
,WebKitGeolocationPosition *position
);
Notify manager
that position has been updated to position
.
Since: 2.26
void webkit_geolocation_manager_failed (WebKitGeolocationManager *manager
,const char *error_message
);
Notify manager
that determining the position failed.
Since: 2.26
gboolean
webkit_geolocation_manager_get_enable_high_accuracy
(WebKitGeolocationManager *manager
);
Get whether high accuracy is enabled.
Since: 2.26
WebKitGeolocationPosition * webkit_geolocation_position_new (double latitude
,double longitude
,double accuracy
);
Create a new WebKitGeolocationPosition
latitude |
a valid latitude in degrees |
|
longitude |
a valid longitude in degrees |
|
accuracy |
accuracy of location in meters |
Since: 2.26
WebKitGeolocationPosition *
webkit_geolocation_position_copy (WebKitGeolocationPosition *position
);
Make a copy of the WebKitGeolocationPosition
Since: 2.26
void
webkit_geolocation_position_free (WebKitGeolocationPosition *position
);
Free the WebKitGeolocationPosition
Since: 2.26
void webkit_geolocation_position_set_timestamp (WebKitGeolocationPosition *position
,guint64 timestamp
);
Set the position
timestamp. By default it's the time when the position
was created.
Since: 2.26
void webkit_geolocation_position_set_altitude (WebKitGeolocationPosition *position
,double altitude
);
Set the position
altitude
Since: 2.26
void webkit_geolocation_position_set_altitude_accuracy (WebKitGeolocationPosition *position
,double altitude_accuracy
);
Set the accuracy of position
altitude
Since: 2.26
void webkit_geolocation_position_set_heading (WebKitGeolocationPosition *position
,double heading
);
Set the position
heading, as a positive angle between the direction of movement and the North
direction, in clockwise direction.
Since: 2.26
void webkit_geolocation_position_set_speed (WebKitGeolocationPosition *position
,double speed
);
Set the position
speed
Since: 2.26
typedef struct _WebKitGeolocationPosition WebKitGeolocationPosition;
WebKitGeolocationPosition is an opaque struct used to provide position updates to a
WebKitGeolocationManager using webkit_geolocation_manager_update_position()
.
Since: 2.26
“enable-high-accuracy”
property“enable-high-accuracy” gboolean
Whether high accuracy is enabled. This is a read-only property that will be
set to TRUE
when a WebKitGeolocationManager needs to get accurate position updates.
You can connect to notify::enable-high-accuracy signal to monitor it.
Flags: Read
Default value: FALSE
Since: 2.26
“start”
signalgboolean user_function (WebKitGeolocationManager *manager, gpointer user_data)
The signal is emitted to notify that manager
needs to start receiving
position updates. After this signal is emitted the user should provide
the updates using webkit_geolocation_manager_update_position()
every time
the position changes, or use webkit_geolocation_manager_failed()
in case
it isn't possible to determine the current position.
If the signal is not handled, WebKit will try to determine the position using GeoClue if available.
manager |
the WebKitGeolocationManager on which the signal is emitted |
|
user_data |
user data set when the signal handler was connected. |
TRUE
to stop other handlers from being invoked for the event.
FALSE
to propagate the event further.
Flags: Run Last
Since: 2.26
“stop”
signalvoid user_function (WebKitGeolocationManager *manager, gpointer user_data)
The signal is emitted to notify that manager
doesn't need to receive
position updates anymore.
manager |
the WebKitGeolocationManager on which the signal is emitted |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 2.26