对 'CoreLocation' say so easy

应用场景

定位
地图
- CoreLocation : 用于地理定位, 地理编码, 区域监听等(着重功能实现)
- MapKit : 用于地图展示, 例如大头针, 路线, 覆盖层展示等(着重界面展示)

1.CoreLocation框架的使用

CoreLocation框架使用前提
- 导入框架 (Xcode5.0之后可以省略, 在使用框架里类的时候会自动导入, 但是如果是使用xib或者storyboard导入的MapKit框架类似, 没有使用类初始化就会崩溃!)
  
  导入CoreLocation框架
导入主头文件

```objc
#import <CoreLocation/CoreLocation.h>
```

CoreLocation框架使用须知
- CoreLocation框架中的所有数据类型的前缀都是CL
- CoreLoaction中使用CLLocationManager对象来做用户定位

2.CLLocationManager

CLLocationManager常用操作
- 开始更新用户位置
```
  - (void)startUpdatingLocation;
```
- 停止更新用户位置
```
  - (void)stopUpdatingLocation;
```
当调用了startUpdatingLocation方法后, 就开始不断地请求/刷新用户的位置, 一旦请求到用户位置就会调用代理的下面的方法

-(void)locationManager:(nonnull CLLocationManager *)manager didUpdateLocations:(nonnull NSArray<CLLocation *> *)locations;

- `locations`参数里面装着所有的`CLLocation`对象, 一般取`lastObject`即可

CLLocationManager补充
- 为了严谨起见, 最好在使用定位功能之前判断当前应用的定位功能是否已经可用
- CLLocationManager有个类方法可以判断当前应用的定位功能是否可用
```
+ (BOOL)locationServicesEnabled;
```
- 每隔多少米定位一次->distanceFilter
- 位置精确度 (越精确就越耗电, 所以要根据需求合理选择) -> disiredAccuracy

3.CLLocation

CLLocaiton用来表示某个位置的地理位置信息, 比如经纬度/海拔等
经纬度

@property(readonly, nonatomic) CLLocationCoordinate2D coordinate;

海拔

@property(readonly, nonatomic) CLLocationDistance altitude;

路线, 航向 (取值范围是0.0° - 359.9° , 0.0° 代表正北方向)

@property(readonly, nonatomic) CLLocationDirection course

移动速度 (单位m/s)

@property(readonly, nonatomic) CLLocationSpeed speed

计算两个位置之间的距离

- (CLLocationDistance)distanceFromLocation:(const CLLocation *)location

4.用户隐私的保护

从IOS6开始, 苹果在用户隐私方面做了很大的加强, 以下操作都必须经过用户批准授权
- 想要获取用户的位置信息
- 想访问用户的通讯录/日历/相机/相册/发送通知等等
当想访问用户的隐私信息时, 系统会自动弹出一个对话框让用户授权

授权批准
开发者可以在Info.plist中设置NSLocationUsageDescription说明定位的目的提示给用户(Privacy - Location Usage Description) 然后就能看到上面类似的请求访问

授权描述
- 一旦用户选择了Don't Allow, 这意味着您的应用以后都无法使用定位功能, 除非到设置里面找到隐私对应用开启定位授权或者卸载重新安装
- 为了提高用户的授权概率, 所以描述信息一定要吸引用户!

5. iOS 8.0+ 的定位适配

从iOS 8.0开始, 苹果进一步加强了对用用户隐私的保护.
- 当APP想访问用户的隐私信息时,根据iOS8.0之前的配置系统不在自动弹出对话框让用户授权
解决方案
- (1) 调用 *iOS 8.0 的 API, 主动请求用户授权

// 请求允许在前后台都能获取用户授权

(void)requestAlwaysAuthorization
// 请求允许在前台获取用户位置的授权

(void)requestWhenInUseAuthorization

- (2) 务必在**Info.plist**文件中配置对应的键值信息, 否则以上请求授权的方法也不生效**(配合步骤(1)联合使用才有效)**
```objc

NSLocationAlwaysUsageDescription: 允许在前后台获取GPS信息的描述
NSLocationWhenInUseDescription: 允许在前台获取GPS的描述
```

注意: 所有想在后台获取位置信息的情况, 都必须开启App的后台模式: location updates

设置后台模式

6. iOS 9.0 定位补充

iOS 9.0 如果当前处于前台授权状态, 默认是不可以后台获取用户位置. 但可以设置一下属性为YES, 就可以继续后去后台位置, 但是会在屏幕上方出现蓝条

@property(assign, nonatomic) BOOL allowsBackgroundLocationUpdates
```

蓝条

iOS 9.0 可以单次请求用户位置

- (void)requestLocation  // 单次请求
- (void)locationManager:(nonnull CLLocationManager *)manager didUpdateLocations:(nonnull NSArray<CLLocation *> *)locations  // 成功调用
- (void)locationManager:(nonnull CLLocationManager *)manager didFailWithError:(nonnull NSError *)error  // 失败调用

7. CLLocationCoordinate2D

CLLocationCoordinate2D是一个用来表示经纬度的结构体, 定义如下

typedef struct {
    CLLocationDegress latitude;  // 经度
    CLLocationDegress longitude;   // 纬度
} CLLocationCoordinate2D;

一般用CLLocationCoordinate2DMake函数来创建CLLocationCoordinate2D

----
####8. 模拟位置
- 如果是模拟器, 可以自定义位置(经纬度)
![模拟器自定义位置](http://upload-images.jianshu.io/upload_images/1176549-9c98843b16c95cbf.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
![设置经纬度](http://upload-images.jianshu.io/upload_images/1176549-48b799cd0b5648f4.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
----
####9. CLGeocoder
- 使用`CLGeocoder`可以完成"地理编码" 和 "反地理编码" 
  - 地理编码: 根据给定的地名, 获得具体的位置信息 (比如经纬度, 地址的全称等)
  - 反地理编码: 根据给定的经纬度, 获得具体的位置信息
- 地理编码方法
```objc
- (void)geocodeAddressString:(NSString *)addressString completionHandler:(CLGeocodeCompletionHandler)completionHandler;

反地理编码方法

- (void)reverseGeocodeLocation:(CLLocation *)location completionHandler:(CLGeocodeCompletionHandler)completionHandler;

CLGeocodeCompletionHandler
- 当地理/反地理编码完成时, 就会调用CLGeocodeCompletionHandler

typedef void (^CLGeocodeCompletionHandler)(NSArray *placemarks, NSError *error);
```
- 这个block传递两个参数
- error: 当编码出错时 (比如编码不出具体的信息) 有值
- placemarks: 里面装着CLPlacemark对象

10. CLPlacemark

CLPlacemark的字面意思是地标, 封装相信的地址位置信息
- 地理位置

@property (nonatomic, readonly, copy, nullable) CLLocation *location;
- 区域objc
@property (nonatomic, readonly, copy, nullable) CLRegion *region;
- 详细的地址信息objc
@property (nonatomic, readonly, copy, nullable) NSDictionary *addressDictionary;
- 地址名称objc
@property (nonatomic, readonly, copy, nullable) NSString *name;
- 城市objc
@property (nonatomic, readonly, copy, nullable) NSString *locality;
```