:right-sidebar: True

GeolocationPermissionRequest
===================================================================

.. currentmodule:: gi.repository.WebKit





.. class:: GeolocationPermissionRequest(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.WebKit.PermissionRequest`



A permission request for sharing the user's location.

WebKitGeolocationPermissionRequest represents a request for
permission to decide whether WebKit should provide the user's
location to a website when requested through the Geolocation API.

When a WebKitGeolocationPermissionRequest is not handled by the user,
it is denied by default.

When embedding web views in your application, you *must* configure an
application identifier to allow web content to use geolocation services.
The identifier *must* match the name of the ``.desktop`` file which describes
the application, sans the suffix.

If your application uses :obj:`~gi.repository.Gio.Application` (or any subclass like
:obj:`~gi.repository.Gtk.Application`\), WebKit will automatically use the identifier returned by
:func:`~gi.repository.Gio.Application.get_application_id`. This is the recommended approach for
enabling geolocation in applications.

If an identifier cannot be obtained through :obj:`~gi.repository.Gio.Application`\, the value
returned by :func:`~gi.repository.GLib.get_prgname` will be used instead as a fallback. For
programs which cannot use :obj:`~gi.repository.Gio.Application`\, calling :func:`~gi.repository.GLib.set_prgname` early
during initialization is needed when the name of the executable on disk
does not match the name of a valid ``.desktop`` file.