PySide6.QtCore.QLocationPermission¶

class QLocationPermission¶

Access the user’s location. More…

Added in version 6.5.

Synopsis¶

Methods¶

def __init__()
def accuracy()
def availability()
def setAccuracy()
def setAvailability()
def swap()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description¶

By default the request is for approximate accuracy, and only while the application is in use. Use setAccuracy() and/or setAvailability() to override the default.

Requirements¶

To request this permission at runtime, the following platform specific usage declarations have to be made at build time:

Platform

Type

macOS

Usage description

NSLocationUsageDescription

iOS

Usage description

NSLocationWhenInUseUsageDescription, and NSLocationAlwaysAndWhenInUseUsageDescription if requesting Always

Android

uses-permission :ref:` <Application-Permissions>`

android.permission.ACCESS_FINE_LOCATION for Precise

android.permission.ACCESS_COARSE_LOCATION for Approximate

android.permission.ACCESS_BACKGROUND_LOCATION for Always

Note

Always uses-permission string has to be combined with one or both of Precise and Approximate strings.

Platform	Type
macOS	Usage description	`NSLocationUsageDescription`
iOS	Usage description	`NSLocationWhenInUseUsageDescription`, and `NSLocationAlwaysAndWhenInUseUsageDescription` if requesting `Always`
Android	`uses-permission` :ref:` <Application-Permissions>`	`android.permission.ACCESS_FINE_LOCATION` for `Precise` `android.permission.ACCESS_COARSE_LOCATION` for `Approximate` `android.permission.ACCESS_BACKGROUND_LOCATION` for `Always` Note `Always` `uses-permission` string has to be combined with one or both of `Precise` and `Approximate` strings.

Please see the individual usage declaration types for how to add them to your project.

See also

QPermission requestPermission() checkPermission() Application Permissions

class Accuracy¶

This enum is used to control the accuracy of the location data.

Constant

Description

QLocationPermission.Approximate

An approximate location is requested.

QLocationPermission.Precise

A precise location is requested.

Constant	Description
QLocationPermission.Approximate	An approximate location is requested.
QLocationPermission.Precise	A precise location is requested.

class Availability¶

This enum is used to control the availability of the location data.

Constant

Description

QLocationPermission.WhenInUse

The location is only available only when the application is in use.

QLocationPermission.Always

The location is available at all times, including when the application is in the background.

Constant	Description
QLocationPermission.WhenInUse	The location is only available only when the application is in use.
QLocationPermission.Always	The location is available at all times, including when the application is in the background.

__init__()¶

__init__(other)

Parameters:: other – QLocationPermission

accuracy()¶

Return type:: Accuracy

Returns the accuracy of the request.

See also

setAccuracy()

availability()¶

Return type:: Availability

Returns the availability of the request.

See also

setAvailability()

setAccuracy(accuracy)¶

Parameters:: accuracy – Accuracy

Sets the desired accuracy of the request.

See also

accuracy()

setAvailability(availability)¶

Parameters:: availability – Availability

Sets the desired availability of the request.

See also

availability()

swap(other)¶

Parameters:: other – QLocationPermission