Location

Airship exposes a very simple, high-level API for requesting location updates, through UALocation.

AirshipLocation

In Airship SDK 13.0, location services are part of an optional standalone framework, called AirshipLocation. In order to access Airship location services, first add a separate import statement in your code, as shown below.

import AirshipLocation

@import AirshipLocation;

To access the location instance, simply call the following method.

UALocation *location = UALocation.shared;

let location = UALocation.shared

Enabling location

Airship’s location framework relies on Apple’s significant-change location service, which lessens battery impact but requires always-on usage. See Getting the User’s Location for details.

Before you can access the user’s location, the user must authorize your application via a location authorization prompt. For the authorization prompt to display properly, you must add the NSLocationAlwaysUsageDescription and NSLocationAlwaysAndWhenInUseUsageDescription keys to your application’s info.plist.

UALocation.shared.isLocationUpdatesEnabled = true

UALocation.shared.locationUpdatesEnabled = YES;

When location updates are enabled for the first time it will prompt the user for permission. This behavior can be changed by disabling autoRequestAuthorizationEnabled.

Allow Background Location

Once the app backgrounds, location updates will be suspended by default, then resumed again once the app is foregrounded. To allow location updates to continue in the background, enable backgroundLocationUpdatesAllowed:

UALocation.shared.isBackgroundLocationUpdatesAllowed = true

UALocation.shared.backgroundLocationUpdatesAllowed = YES;