iOS-定位

大数据时代，用户对自己的隐私安全越来越关注，所以，随着iOS系统更新，苹果对用户隐私相关(定位、相册、网络、粘贴板等)权限控制持续升级。其中定位权限相关申请API与配置项较多，本文旨在记录说明 iOS8.0 - 14.0beta 从权限申请到获取定位数据流程。

内容包括定位权限、获取定位数据、定位权限API调用实践。定位权限模块按照系统相关性分别介绍该系统下权限配置与API调用细节、注意事项与表格总结；获取定位数据模块介绍定位关键参数、单次/连续定位等；调用实践模块介绍了从 iOS8.0 - 14.0beta 系统定位权限的适配实践。

 注意：此权限下，如果Xcode勾选 Capabilities -> UIBackgroundModes > Location updates并且allowsBackgroundLocationUpdates设为YES，则app退到后台仍可获取定位数据，但此时在手机上方会有定位小蓝条提示；

 注意：此权限下，当app在后台时，系统默认不展示定位小蓝条，可通过showsBackgroundLocationIndicator控制小蓝条是否显示；

 注意：1）直接调用requestAlwaysAuthorization申请权限时，权限弹窗与调用requestWhenInUseAuthorization一样，如上图，用户只可以选择应用使用时或者只允许一次。不同点：当选择使用app时允许选项后，状态变更的回调为kCLAuthorizationStatusAuthorizedAlways；并且当app退到后台后，系统会择机弹窗提示用户是否要升级权限为始终允许。如下图：

2）如果想要在应用使用期间弹窗申请始终允许，则需要先调用requestWhenInUseAuthorization，并且获得应用使用期间定位权限，之后在调用requestAlwaysAuthorization则可弹窗申请始终允许，如下图；（感觉不是太友好，不建议使用）

<key>NSLocationTemporaryUsageDescriptionDictionary</key>

<dict>

  ExampleUsageDescription

  This app needs accurate location so it can verify that you are in a supported region.

  AnotherUsageDescription

  This app needs accurate location so it can show you relevant results.

</dict>

  -需要注意该字段类型为Boolean，如果为其他类型则不起效；

  -配置该字段后，申请定位权限的小地图左上角则没有精确开关，默认关闭，如下面图示。但是如果info.plist中配置了NSLocationTemporaryUsageDescriptionDictionary，则仍可以申请临时的精确定位权限；

  -⚠️：测试期间使用Xcode12 beta1到beta4，直接使用info.plist的Property List添加NSLocationDefaultAccuracyReduced字段只能是string，所以会造成不起效的问题，如果您也遇到类似问题，可以点击info.plist右键Open As -> Source Code，即使用源码直接添加既可起效；

<key>NSLocationDefaultAccuracyReduced</key>

<true/>

CLActivityTypeFitness,                        //健身活动，如步行、跑步、骑车等；

CLActivityTypeAirborne                       //空中飞行定位（iOS12及以上版本）

//前置步骤：创建定位管理类CLLocationManager，配置定位参数

//开始定位

- (void)startLocation{

//self.locationManager = [[CLLocationManager alloc]init];

//self.locationManager.allowsBackgroundLocationUpdates = YES;

//self.locationManager.delegate = self;

    if([self locationServiceIsValid] == NO){

        NSLog(@"用户拒绝该app使用定位服务");

        return;

    }

    //该场景下是否需要精确定位

    BOOL isNeedFullAccuracy = YES;

    //该场景下如果需要精确定位，则对应的plist中配置的key

    NSString *purposeKey = @"ExampleUsageDescription";

    //判断当前定位权限是否ok

    [self checkLocationAuthorizationStatus:self.locationManager

                           needFullAccuracy:isNeedFullAccuracy

                                 purposeKey:purposeKey];

    //开始连续定位

    [self.locationManager startUpdatingLocation];

}

//获取当前定位权限

- (CLAuthorizationStatus)authorizationStatus

{

    if (@available(iOS 14.0, *)) {

        return self.locationManager.authorizationStatus;

    } else {

        return [CLLocationManager authorizationStatus];

    }

}

//当前应用是否可以使用/申请定位服务

- (BOOL)locationServiceIsValid{

    if ([self authorizationStatus] == kCLAuthorizationStatusDenied ||

        [self authorizationStatus] == kCLAuthorizationStatusRestricted) {

        return NO;

    }

    return YES;

}

//当前定位状态是否可用

- (BOOL)locationAuthStatusIsValid{

    if ([self locationServiceIsValid] == NO) {

        return  NO;

    }

    if ([self authorizationStatus] == kCLAuthorizationStatusNotDetermined) {

        return NO;

    }

    return YES;

}

//核实当前权限状态，判断是否需要申请权限或者权限升级

- (void)checkLocationAuthorizationStatus:(CLLocationManager *)manager

                         needFullAccuracy:(BOOL)isNeedFullAccuracy

                                purposeKey:(NSString *)purposeKey{

      if([self authorizationStatus] == kCLAuthorizationStatusNotDetermined){

          //如果没有定位权限，则需要先申请定位权限

          //如果是iOS14申请权限弹窗时可以选择精度开关，所以不用在单独处理精度权限

          [self requestLocationAuthorizationIfNeed:manager];

      }else if(isNeedFullAccuracy){

          //如果已经有定位权限且需要精确定位

            [self requestTemporaryFullAccuracyAuthorizationIfNeed:manager purposeKey:purposeKey];

      }

}

//如果当前场景需要精确定位，则可以申请一次临时精确定位

- (void)requestTemporaryFullAccuracyAuthorizationIfNeed:(CLLocationManager *)manager

                                             purposeKey:(NSString *)purposeKey

{

    //如果是非iOS14系统，则默认为精确定位

    if (@available(iOS 14.0, *)) {

        //如果已经获得定位权限，但精度权限只是模糊定位

        if (manager.accuracyAuthorization == CLAccuracyAuthorizationReducedAccuracy) {

            NSDictionary *locationTemporaryDictionary = [[NSBundle mainBundle]

                        objectForInfoDictionaryKey:@"NSLocationTemporaryUsageDescriptionDictionary"];

            BOOL hasLocationTemporaryKey = locationTemporaryDictionary != nil && locationTemporaryDictionary.count != 0;

            if (hasLocationTemporaryKey) {

                //此API不能用于申请定位权限，只能用于从模糊定位升级为精确定位；申请定位权限只能调用

                //requestWhen或requestAlways，如果没有获得定位权限，直接调用此API无效。

                [manager requestTemporaryFullAccuracyAuthorizationWithPurposeKey:purposeKey completion:nil];

            }else{

                NSLog(@"如果需要使用临时精确定位，需要在Info.plist中添加 \

                NSLocationTemporaryUsageDescriptionDictionary字段。");

            }

        }

    }

 }

//请求定位权限，

- (void)requestLocationAuthorizationIfNeed:(CLLocationManager *)manager

{

    //系统版本号

    CGFloat systemVersion = [[[UIDevice currentDevice] systemVersion] floatValue];

    //系统版本8+ && 没有选择过定位权限

    if (systemVersion > 7.99 && [CLLocationManager authorizationStatus] == kCLAuthorizationStatusNotDetermined)

    {

        //获取info.plist中配置字段信息

        BOOL hasAlwaysKey = [[NSBundle mainBundle] objectForInfoDictionaryKey:@"NSLocationAlwaysUsageDescription"] != nil;

        BOOL hasWhenInUseKey = [[NSBundle mainBundle] objectForInfoDictionaryKey:@"NSLocationWhenInUseUsageDescription"] != nil;

        BOOL hasAlwaysAndWhenInUseKey = [[NSBundle mainBundle] objectForInfoDictionaryKey:@"NSLocationAlwaysAndWhenInUseUsageDescription"] != nil;

        //如果是iOS11及以后版本。（当前iOS11到13居多）

        if (@available(iOS 11.0, *)){

            if (hasAlwaysAndWhenInUseKey && hasWhenInUseKey)

            {

                //如果plist同时配置两个字段，则两个权限申请API都可以调用；

                //建议直接调用requestAlwaysAuthorization即可

                [manager requestAlwaysAuthorization];

            }

            else if (hasWhenInUseKey)

            {

                //如果plist只配置InUseKey，则只能调用使用时API

                [manager requestWhenInUseAuthorization];

            }

            else{

                NSLog(@"要在iOS11及以上版本使用定位服务, 需要在Info.plist中添加 \

                NSLocationAlwaysAndWhenInUseUsageDescription和NSLocationWhenInUseUsageDescription字段。");

            }

        }

        else

        {

            if (hasAlwaysKey)

            {

                //如果plist配置hasAlwaysKey，则可以调用始终允许API

                [manager requestAlwaysAuthorization];

            }

            else if (hasWhenInUseKey)

            {

                //如果plist配置hasAlwaysKey，则可以调用始终允许API

                [manager requestWhenInUseAuthorization];

            }

            else

            {

                NSLog(@"要在iOS8到iOS10版本使用定位服务, 需要在Info.plist中添加 \

                NSLocationAlwaysUsageDescription或者NSLocationWhenInUseUsageDescription字段。");

            }

        }

    }

}

//核实当前权限状态，判断是否需要申请权限或者权限升级

- (void)checkLocationAuthorizationStatus:(CLLocationManager *)manager

                         needFullAccuracy:(BOOL)isNeedFullAccuracy

                                purposeKey:(NSString *)purposeKey{

      if([self authorizationStatus] == kCLAuthorizationStatusNotDetermined){

          //如果没有定位权限，则需要先申请定位权限

          //如果是iOS14申请权限弹窗时可以选择精度开关，所以不用在单独处理精度权限

          [self requestLocationAuthorizationIfNeed:manager];

      }else if(isNeedFullAccuracy){

          //如果已经有定位权限且需要精确定位

            [self requestTemporaryFullAccuracyAuthorizationIfNeed:manager purposeKey:purposeKey];

      }

}

//如果当前场景需要精确定位，则可以申请一次临时精确定位

- (void)requestTemporaryFullAccuracyAuthorizationIfNeed:(CLLocationManager *)manager

                                             purposeKey:(NSString *)purposeKey

{

    //如果是非iOS14系统，则默认为精确定位

    if (@available(iOS 14.0, *)) {

        //如果已经获得定位权限，但精度权限只是模糊定位

        if (manager.accuracyAuthorization == CLAccuracyAuthorizationReducedAccuracy) {

            NSDictionary *locationTemporaryDictionary = [[NSBundle mainBundle]

                        objectForInfoDictionaryKey:@"NSLocationTemporaryUsageDescriptionDictionary"];

            BOOL hasLocationTemporaryKey = locationTemporaryDictionary != nil && locationTemporaryDictionary.count != 0;

            if (hasLocationTemporaryKey) {

                //此API不能用于申请定位权限，只能用于从模糊定位升级为精确定位；申请定位权限只能调用

                //requestWhen或requestAlways，如果没有获得定位权限，直接调用此API无效。

                [manager requestTemporaryFullAccuracyAuthorizationWithPurposeKey:purposeKey completion:nil];

            }else{

                NSLog(@"如果需要使用临时精确定位，需要在Info.plist中添加 \

                NSLocationTemporaryUsageDescriptionDictionary字段。");

            }

        }

    }

 }

//请求定位权限，

- (void)requestLocationAuthorizationIfNeed:(CLLocationManager *)manager

{

    //系统版本号

    CGFloat systemVersion = [[[UIDevice currentDevice] systemVersion] floatValue];

    //系统版本8+ && 没有选择过定位权限

    if (systemVersion > 7.99 && [CLLocationManager authorizationStatus] == kCLAuthorizationStatusNotDetermined)

    {

        //获取info.plist中配置字段信息

        BOOL hasWhenInUseKey = [[NSBundle mainBundle] objectForInfoDictionaryKey:@"NSLocationWhenInUseUsageDescription"] != nil;

        if (hasWhenInUseKey)

        {

            //如果plist配置InUseKey，则只能调用使用时API

            [manager requestWhenInUseAuthorization];

        }

        else{

            NSLog(@"要在iOS8及以上版本使用定位服务, 需要在Info.plist中添加 \

            NSLocationWhenInUseUsageDescription字段。");

        }

    }

}

//iOS13及以前版本回调

- (void)locationManager:(CLLocationManager *)manager didChangeAuthorizationStatus:(CLAuthorizationStatus)status

{

    [self locationStatusDidChanged:[CLLocationManager authorizationStatus]];

}

//iOS14及以后版本回调

- (void)locationManagerDidChangeAuthorization:(CLLocationManager *)manager

{

    if (@available(iOS 14.0, *)) {

        [self locationStatusDidChanged:manager.authorizationStatus];

        if([self locationAuthStatusIsValid]){

            CLAccuracyAuthorization accuracyAuth = manager.accuracyAuthorization;

            if (accuracyAuth == CLAccuracyAuthorizationReducedAccuracy){

                NSLog(@"TODO: 可以模糊定位");

            }else{

                NSLog(@"TODO: 可以精确定位");

            }

            //该场景下是否需要精确定位

            BOOL isNeedFullAccuracy = YES;

            if (isNeedFullAccuracy == YES && accuracyAuth == CLAccuracyAuthorizationReducedAccuracy) {

                NSLog(@"TODO: 该场景需要精确定位才可以使用，请去设置中打开精确定位开关");

            }

        }

    } else {

    }

}

- (void)locationStatusDidChanged:(CLAuthorizationStatus)authStatus

{

    switch (authStatus) {

        case kCLAuthorizationStatusNotDetermined:

            NSLog(@"可以申请定位权限");

            break;

        case kCLAuthorizationStatusRestricted:

        case kCLAuthorizationStatusDenied:

            NSLog(@"TODO: 没有定位权限");

            break;

        case kCLAuthorizationStatusAuthorizedAlways:

        case kCLAuthorizationStatusAuthorizedWhenInUse:

            NSLog(@"TODO: 拥有定位权限");

        default:

            break;

    }

}

//定位回调

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

{

    CLLocation *locationg = locations.lastObject;

    NSLog(@"TODO: 收到定位数据：%@",locationg);

}