Latest 1.0.1
Homepage https://github.com/paleksandrs/APScheduledLocationManager
License MIT
Platforms ios 9.0

license MIT

Location manager that allows to get background location updates every n seconds with desired location accuracy.

n – range is between 2 – 170 seconds (limited by max allowed background task time)

Requirements

  • Xcode 8
  • Swift 3.0
  • iOS 9.0+

Installation

CocoaPods. Please use the latest CocoaPods as this framework is using Swift 3
use_frameworks!

pod 'APScheduledLocationManager'

Usage

1. Configure Xcode project

In target Capabilities enable Background Modes and check Location updates

In Info.plist add NSLocationAlwaysUsageDescription key and value that will specify the reason for your app to access the user’s location information at all times.

2. Import APScheduledLocationManager and CoreLocation
import APScheduledLocationManager
import CoreLocation
3. Create instance of APScheduledLocationManager
let manager = APScheduledLocationManager(delegate: self)
4. Confirm to APScheduledLocationManagerDelegate
func scheduledLocationManager(_ manager: APScheduledLocationManager, didFailWithError error: Error){

}

func scheduledLocationManager(_ manager: APScheduledLocationManager, didUpdateLocations locations: [CLLocation]) {

}

func scheduledLocationManager(_ manager: APScheduledLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {

}
5. Request authorized always permission

You can use requestAlwaysAuthorization helper method of APScheduledLocationManager or your own implementation.

6. Start location manager when permission is granted
manager.startUpdatingLocation(interval: 170, acceptableLocationAccuracy: 100)

There are 2 options to adjust the location manager:

  • interval: TimeInterval – interval with which the location will be gathered. The range is between 2 – 170 seconds, lower or higher values will be overwritten
  • acceptableLocationAccuracy: CLLocationAccuracy – the location manager will wait till locations with desired accuracy are retrieved.
7. To stop location manager call stopLocationManager

Example

See an example app ScheduledLocationExample in the repository

Note, if you test on a stimulater edit scheme and set default location.

License

APScheduledLocationManager is released under an MIT License. See LICENSE for details.

Latest podspec

{
    "name": "APScheduledLocationManager",
    "version": "1.0.1",
    "summary": "Location manager that allows to get background location updates every n seconds",
    "description": "Location manager that allows to get background location updates every n seconds with desired location accuracy.",
    "homepage": "https://github.com/paleksandrs/APScheduledLocationManager",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": "Aleksandrs Proskurins",
    "platforms": {
        "ios": "9.0"
    },
    "source": {
        "git": "https://github.com/paleksandrs/APScheduledLocationManager.git",
        "tag": "1.0.1"
    },
    "source_files": "APScheduledLocationManager/*.swift",
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This