requestAlwaysAuthorization()
Requests the user’s permission to use location services regardless of whether the app is in use.
Declaration
func requestAlwaysAuthorization()Discussion
You must call this or the requestWhenInUseAuthorization() method before your app can receive location information. To call this method, you must have both NSLocationAlwaysUsageDescription and NSLocationWhenInUseUsageDescription keys in your app’s Info.plist file. You may call requestAlwaysAuthorization() when the current authorization state is either:
Not Determined — CLAuthorizationStatus.notDetermined
When In Use — CLAuthorizationStatus.authorizedWhenInUse
Use the locationManager(_:didUpdateLocations:) method on the CLLocationManager delegate to receive updates when the user makes permission choices.
Core Location limits calls to requestAlwaysAuthorization(). After your app calls this method, further calls have no effect. If a compatible iPad or iPhone app calls this method when running in visionOS, the method treats it as a request for When in Use authorization instead.
Request Always Authorization After Getting When In Use
To obtain Always authorization, your app must first request When In Use permission followed by requesting Always authorization.
If the user grants When In Use permission after your app calls requestWhenInUseAuthorization(), then calling requestAlwaysAuthorization() immediately prompts the user to request Always permission. If the user responded to requestWhenInUseAuthorization() with Allow Once, then Core Location ignores further calls to requestAlwaysAuthorization() due to the temporary authorization.
Core Location prompts the user to grant permission with the string from NSLocationAlwaysUsageDescription. The user prompt displays the following options, which determine the authorization your app can receive:
Option | Authorization |
|---|---|
Keep Only While Using | Core Location leaves the authorization as When In Use. The delegate doesn’t receive any updates. |
Change to Always Allow | Core Location grants your app Always authorization. The delegate receives Authorizedalways. |
Request Always Authorization Directly
If your app’s current state is CLAuthorizationStatus.notDetermined and you call requestAlwaysAuthorization(), Core Location uses two prompts before it fully enables Always authorization.
The first prompt displays immediately with the string from NSLocationWhenInUseUsageDescription. The user prompt displays the following options, which determine the authorization your app receives:
Option | Authorization |
|---|---|
Allow While Using App | Core Location grants your app a Provisional Always authorization. The delegate receives Authorizedalways. |
Allow Once | Core Location grants your app a Temporary When in Use authorization. The delegate receives Authorizedwheninuse. This authorization expires when your app is no longer in use, reverting to Notdetermined. |
Don’t Allow | Core Location marks your app with Denied authorization. The delegate receives Denied. |
The second prompt displays when Core Location prepares to deliver an event to your app requiring CLAuthorizationStatus.authorizedAlways. If the app is in the Provisional Always state, the system displays the second prompt with the string from NSLocationAlwaysUsageDescription. Core Location will typically display the second prompt when your app isn’t running.
Your app receives permanent Always authorization if the user chooses to grant permission when the second prompt appears while in the Provisional Always state. When the user responds, your app receives either the location event or a call to your delegate with the modified authorization.
When displaying the second prompt, the user sees one of the following options:
Option | Authorization |
|---|---|
Keep Only While Using | Core Location changes the authorization to When In Use. The delegate receives Authorizedwheninuse. |
Change to Always Allow | Core Location removes the provisional status, making the Always authorization permanent. The delegate doesn’t receive a callback. |
If the user responds to the prompt near the time it was delivered and chooses to allow the Always permission, the location event will be delivered to your app.