大概简介
设备的朝向方向枚举
/*
* CLDeviceOrientation
* Discussion:
* Specifies a physical device orientation,equivalent to UIDeviceOrientation.
*/
public enum CLDeviceOrientation : Int32 {
case unknown
case portrait
case portraitUpsideDown
case landscapeLeft
case landscapeRight
case faceUp
case faceDown
}
获取当前用户的权限设置
/*
* CLAuthorizationStatus
* Discussion:
* Represents the current authorization state of the application.
*/
public enum CLAuthorizationStatus : Int32 {
// User has not yet made a choice with regards to this application
case notDetermined 还没决定
// This application is not authorized to use location services.Due
// to active restrictions on location services,the user cannot change
// this status,and may not have personally denied authorization
case restricted 没有授权
// User has explicitly denied authorization for this application,or
// location services are disabled in Settings.
case denied 已经明确不授权，或者设置里面压根就不存在这个
// User has granted authorization to use their location at any time,
// including monitoring for regions,visits,or significant location changes.
//
// This value should be used on iOS,tvOS and watchOS.It is available on
// MacOS,but kCLAuthorizationStatusAuthorized is synonymous and preferred.
@available(iOS 8.0,*)
case authorizedAlways 总是有权限
// User has granted authorization to use their location only when your app
// is visible to them(it will be made visible to them if you continue to
// receive location updates while in the background).Authorization to use
// launch APIs has not been granted.
//
// This value is not available on MacOS.It should be used on iOS,tvOS and
// watchOS.
@available(iOS 8.0,*)
case authorizedWhenInUse app 使用时候有权限
// User has authorized this application to use location services.
//
// This value is deprecated or prohibited on iOS,tvOS and watchOS.
// It should be used on MacOS.
@available(iOS,introduced: 2.0,deprecated: 8.0,message: "Use kCLAuthorizationStatusAuthorizedAlways")
public static var authorized: CLAuthorizationStatus { get } iOS 8之后已废弃
}
关于这个类
检查app是否能启动定位服务
locationServicesEnabled()-> Bool
指南针能不能用
headingAvailable()-> Bool
位置发生改变能否监控
significantLocationChangeMonitoringAvailable()-> Bool
某个地区类的改变能否检测到
isMonitoringAvailable(for regionClass: Swift.AnyClass)-> Bool
能否测距
isRangingAvailable()-> Bool
获取当前权限状态
authorizationStatus()-> CLAuthorizationStatus
代理
delegate
对象
设置一个更新定位的距离间距值，如果是kCLDistanceFilterNone的话，用户所有行动都会更新定位
distanceFilter: CLLocationDistance（Double）
定位精度
desiredAccuracy: CLLocationAccuracy
CLLocationAccuracy 对应的枚举 {
public let kCLLocationAccuracyBestForNavigation: CLLocationAccuracy
public let kCLLocationAccuracyBest: CLLocationAccuracy
public let kCLLocationAccuracyNearestTenMeters: CLLocationAccuracy
public let kCLLocationAccuracyHundredMeters: CLLocationAccuracy
public let kCLLocationAccuracyKilometer: CLLocationAccuracy
public let kCLLocationAccuracyThreeKilometers: CLLocationAccuracy
}
自动暂停定位更新
pausesLocationUpdatesAutomatically: Bool
允许后台更新定位，需要设置UIBackgroundModes在Info.plist
allowsBackgroundLocationUpdates: Bool9.0之后支持
showsBackgroundLocationIndicator: Bool 11.0
最新的定位信息
location: CLLocation? { get }
导航过滤器，定义多少角度的改变再去更新，默认是1 degree
headingFilter
只有设备在正常方向才会正确导航（CLDeviceOrientationPortrait is used.其他都ignored）
headingOrientation: CLDeviceOrientation
获取最后的导航方向
heading: CLHeading? { get }
最大的地区监控距离（距离中心点，任何大于此值的区域都会返回kCLErrorRegionMonitoringFailure）
maximumRegionMonitoringDistance: CLLocationDistance { get }
检索当前正在监视的区域的一组对象。如果之前有任何location manager也监控过的话，会将之前的值也添加到这个set里面。
monitoredRegions: Set { get }
检索一组表示该位置管理器主动提供范围的区域的对象
rangedRegions: Set { get }
方法
requestWhenInUseAuthorization()
requestAlwaysAuthorization()
startUpdatingLocation()
stopUpdatingLocation()
requestLocation()
startUpdatingHeading()
stopUpdatingHeading()
立即关闭校准
dismissHeadingCalibrationDisplay()
开启/关闭检测重要位置变化，通过位置变化代理方法进行回调
startMonitoringSignificantLocationChanges()
stopMonitoringSignificantLocationChanges()
1.异步停止监测指定区域，不会及时反馈在monitoredRegions里面
stopMonitoring(for region: CLRegion)
2.之前有注册过得相同标识符的区域，会被移除。相对于非环形和更大的区域，这个方法会优先监控环形的区域和更小的区域。也是异步完成的。不会及时反馈在monitoredRegions里面
startMonitoring(for region: CLRegion)
异步取回特定区域的cache状态，state通过代理方法locationManager:didDetermineState:forRegion:取得
requestState(for region: CLRegion)
开始/结束计算指定区域中信标的范围
startRangingBeacons(in region: CLBeaconRegion)
stopRangingBeacons(in region: CLBeaconRegion)
允许后台以低功耗状态延迟更新位置信息
1.allowDeferredLocationUpdates(untilTraveled distance: CLLocationDistance,timeout: TimeInterval)
2.disallowDeferredLocationUpdates()
3.eferredLocationUpdatesAvailable() -> Bool
