iOS开发之CoreLocation框架使用

简介: iOS开发之CoreLocation框架使用

iOS开发之CoreLocation框架使用


    CoreLocation框架是iOS开发中比较基础的一个位置信息相关框架,关于定位和地图,之前也有博客多详细的介绍。但是对于CoreLocation框架,并没有完整和细致的记录。本篇博客将剖析这个框架的结构并进行应用示例。下图为CoreLocation框架的相关类布局图:


image.png


从图中可以看到,在CoreLocation框架中除了一些数据模型,CLLocationManager作用最为重要,它是整个框架的管理中心,从图中也可以看出,CoreLocation框架功能也非常完善,常规定位,方向信息获取,室内定位,GEO编码等功能都支持。


一、CLLocationManager管理类详解


CLLocationManager作为整个CoreLocation框架的核心管理类,其第一部分功能是获取设备的功能可用性,如下:


//获取位置服务是否可用

+ (BOOL)locationServicesEnabled;

//获取方向信息服务是否可用

+ (BOOL)headingAvailable;

//获取设备是否支持显著位置更改的监听

+ (BOOL)significantLocationChangeMonitoringAvailable;

//获取是否支持针对某种位置区域改变的监听

+ (BOOL)isMonitoringAvailableForClass:(Class)regionClass;

//获取是否支持区域监听 同上面一个函数作用一致

+ (BOOL)regionMonitoringAvailable;

//获取区域监听是否可用 除了设备支持 还需要 用户授权

+ (BOOL)regionMonitoringEnabled;

//获取是否支持测距

+ (BOOL)isRangingAvailable;

在使用CLLocationManager的服务之前,首先需要获取用户的授权,在iOS8之后,还需要在info.plist中添加相关的键,如下:

image.png



上面标出的3个键,只需要设置一个,根据自己的定位要求来选择即可。


下面列出了与用户授权相关的方法:


//获取当前用户授权类型

/*

CLAuthorizationStatus枚举如下:

kCLAuthorizationStatusNotDetermined  用户目前还没有选择

kCLAuthorizationStatusRestricted     当前应用尚未授权

kCLAuthorizationStatusDenied         用户拒绝使用位置服务

kCLAuthorizationStatusAuthorizedAlways 用户授权始终可以使用位置服务

kCLAuthorizationStatusAuthorizedWhenInUse 用户授权可以在APP使用时使用位置

kCLAuthorizationStatusAuthorized      用户授权使用位置  iOS8之前

*/

+ (CLAuthorizationStatus)authorizationStatus;

//请求在APP使用时使用用户的位置信息

- (void)requestWhenInUseAuthorization;

//请求始终使用用户的位置信息

- (void)requestAlwaysAuthorization;

下面列举了CLLocationManager中核心的属性和方法:


//设置代理

@property(assign, nonatomic, nullable) id<CLLocationManagerDelegate> delegate;

//定位服务是否可用

@property(readonly, nonatomic) BOOL locationServicesEnabled;

//位置服务的用途,目前这个属性不再使用,在info.plist中配置

@property(copy, nonatomic, nullable) NSString *purpose;

//指定定位活动的行为

/*

CLActivityTypeAutomotiveNavigation 汽车导航

CLActivityTypeFitness    步行

CLActivityTypeOtherNavigation  其他导航 如火车 轮船

CLActivityTypeAirborne  飞机导航

CLActivityTypeOther 其他类型


*/

@property(assign, nonatomic) CLActivityType activityType;

//设置以米为单位的精度,当小于此精度的位置改变不会收到通知CLLocationDistance就是double类型

@property(assign, nonatomic) CLLocationDistance distanceFilter;

//设置预期的定位精度CLLocationAccuracy为double类型 不一定完全精准 只是设置预期

@property(assign, nonatomic) CLLocationAccuracy desiredAccuracy;

//设置是否自动暂停位置更新 根据电量等

@property(assign, nonatomic) BOOL pausesLocationUpdatesAutomatically;

//设置是否在后台一直更新定位

@property(assign, nonatomic) BOOL allowsBackgroundLocationUpdates;

//当后台定位时 是否显示活动指示器 在状态栏上

@property(assign, nonatomic) BOOL showsBackgroundLocationIndicator;

//最近的一次位置信息

@property(readonly, nonatomic, copy, nullable) CLLocation *location;

//是否支持方向

@property(readonly, nonatomic) BOOL headingAvailable;

//设置最小方向更新精度

@property(assign, nonatomic) CLLocationDegrees headingFilter;

//用来作为参考的物理设备方向

/*

   CLDeviceOrientationUnknown ,

CLDeviceOrientationPortrait,

CLDeviceOrientationPortraitUpsideDown,

CLDeviceOrientationLandscapeLeft,

CLDeviceOrientationLandscapeRight,

CLDeviceOrientationFaceUp,

CLDeviceOrientationFaceDown

*/

@property(assign, nonatomic) CLDeviceOrientation headingOrientation;

//最近一次更新的方向信息

@property(readonly, nonatomic, copy, nullable) CLHeading *heading;

//设置最大的区域监听范围

@property (readonly, nonatomic) CLLocationDistance maximumRegionMonitoringDistance;

//一组目前正在监听的范围集合

@property (readonly, nonatomic, copy) NSSet<__kindof CLRegion *> *monitoredRegions;

//返回一组支持测距的范围

@property (readonly, nonatomic, copy) NSSet<__kindof CLRegion *> *rangedRegions;

//开始更新位置信息

- (void)startUpdatingLocation;

//停止更新位置信息

- (void)stopUpdatingLocation;

//请求一次位置信息

- (void)requestLocation;

//开始更新方向信息

- (void)startUpdatingHeading;

//停止更新方向信息

- (void)stopUpdatingHeading;

//取消航向校准

- (void)dismissHeadingCalibrationDisplay;

//开始显著位置变化的监听

- (void)startMonitoringSignificantLocationChanges;

//停止线束位置变化的监听

- (void)stopMonitoringSignificantLocationChanges;

//开启范围监听

- (void)startMonitoringForRegion:(CLRegion *)region

                desiredAccuracy:(CLLocationAccuracy)accuracy;

- (void)startMonitoringForRegion:(CLRegion *)region;

//停止范围监听

- (void)stopMonitoringForRegion:(CLRegion *)region;

//获取指定区域的状态 会在代理回调中返回

- (void)requestStateForRegion:(CLRegion *)region;

//开始计算信标范围  关于Beacon 是一种专门的室内定位服务

- (void)startRangingBeaconsInRegion:(CLBeaconRegion *)region;

//停止计算信标范围

- (void)stopRangingBeaconsInRegion:(CLBeaconRegion *)region;

//允许延迟更新  即位置改变了多少距离或者间隔了多少秒后更新

- (void)allowDeferredLocationUpdatesUntilTraveled:(CLLocationDistance)distance

      timeout:(NSTimeInterval)timeout;

//不允许进行延迟更新

- (void)disallowDeferredLocationUpdates;

//设备是否支持延迟更新

+ (BOOL)deferredLocationUpdatesAvailable;

二、CLLocationManagerDelegate协议


       CLLocationManagerDelegate配合CLLocationManager进行使用,其中定义了管理器在提供服务时进行回调的相关函数。解析如下:


//位置更新后调用的回调 会将原位置和更新后的位置信息传入

- (void)locationManager:(CLLocationManager *)manager

didUpdateToLocation:(CLLocation *)newLocation

    fromLocation:(CLLocation *)oldLocation;

//位置更新后调用的回调 会传入按时间排序的一组位置信息对象

- (void)locationManager:(CLLocationManager *)manager

 didUpdateLocations:(NSArray<CLLocation *> *)locations;

//方向信息更新后调用的回调

- (void)locationManager:(CLLocationManager *)manager

      didUpdateHeading:(CLHeading *)newHeading;

//返回布尔值设置是否需要进行方向校准

- (BOOL)locationManagerShouldDisplayHeadingCalibration:(CLLocationManager *)manager;

//当监听的区域状态变化时调用

/*

CLRegionState定义区域的状态

CLRegionStateUnknown 未知状态

CLRegionStateInside  进入

CLRegionStateOutside 出去

*/

- (void)locationManager:(CLLocationManager *)manager

didDetermineState:(CLRegionState)state forRegion:(CLRegion *)region ;

//区域内有新的信标可用时调用

- (void)locationManager:(CLLocationManager *)manager

didRangeBeacons:(NSArray<CLBeacon *> *)beacons inRegion:(CLBeaconRegion *)region;

//区域内的信标测距发生错误时调用

- (void)locationManager:(CLLocationManager *)manager

rangingBeaconsDidFailForRegion:(CLBeaconRegion *)region

withError:(NSError *)error;

//进入监听区域时调用

- (void)locationManager:(CLLocationManager *)manager

didEnterRegion:(CLRegion *)region;

//退出监听区域时调用

- (void)locationManager:(CLLocationManager *)manager

didExitRegion:(CLRegion *)region;

//服务发生错误时调用

- (void)locationManager:(CLLocationManager *)manager

didFailWithError:(NSError *)error;

//监听区域发生错误时调用

- (void)locationManager:(CLLocationManager *)manager

monitoringDidFailForRegion:(nullable CLRegion *)region

withError:(NSError *)error;

//用户授权改变时调用

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

//开启区域监听时调用

- (void)locationManager:(CLLocationManager *)manager

didStartMonitoringForRegion:(CLRegion *)region;

//暂停位置更新时调用

- (void)locationManagerDidPauseLocationUpdates:(CLLocationManager *)manager;

//恢复位置更新时调用

- (void)locationManagerDidResumeLocationUpdates:(CLLocationManager *)manager;

//延迟更新位置信息错误时调用

- (void)locationManager:(CLLocationManager *)manager

didFinishDeferredUpdatesWithError:(nullable NSError *)error;

//如果启用了访问监听 则收到访问会调用

- (void)locationManager:(CLLocationManager *)manager didVisit:(CLVisit *)visit;


目录
相关文章
|
1月前
|
Java Android开发 Swift
安卓与iOS开发对比:平台选择对项目成功的影响
【10月更文挑战第4天】在移动应用开发的世界中,选择合适的平台是至关重要的。本文将深入探讨安卓和iOS两大主流平台的开发环境、用户基础、市场份额和开发成本等方面的差异,并分析这些差异如何影响项目的最终成果。通过比较这两个平台的优势与挑战,开发者可以更好地决定哪个平台更适合他们的项目需求。
102 1
|
4天前
|
设计模式 前端开发 Swift
探索iOS开发:从初级到高级的旅程
【10月更文挑战第31天】在这篇文章中,我们将一起踏上iOS开发的旅程。无论你是初学者还是有经验的开发者,这篇文章都将为你提供有价值的信息和技巧。我们将从基础开始,逐步深入到更高级的技术和概念。让我们一起探索iOS开发的世界吧!
|
7天前
|
设计模式 前端开发 Swift
探索iOS开发:从初级到高级的旅程
【10月更文挑战第28天】在这篇技术性文章中,我们将一起踏上一段探索iOS开发的旅程。无论你是刚入门的新手,还是希望提升技能的开发者,这篇文章都将为你提供宝贵的指导和灵感。我们将从基础概念开始,逐步深入到高级主题,如设计模式、性能优化等。通过阅读这篇文章,你将获得一个清晰的学习路径,帮助你在iOS开发领域不断成长。
32 2
|
13天前
|
安全 API Swift
探索iOS开发中的Swift语言之美
【10月更文挑战第23天】在数字时代的浪潮中,iOS开发如同一艘航船,而Swift语言则是推动这艘船前进的风帆。本文将带你领略Swift的独特魅力,从语法到设计哲学,再到实际应用案例,我们将一步步深入这个现代编程语言的世界。你将发现,Swift不仅仅是一种编程语言,它是苹果生态系统中的一个创新工具,它让iOS开发变得更加高效、安全和有趣。让我们一起启航,探索Swift的奥秘,感受编程的乐趣。
|
16天前
|
移动开发 网络协议 小程序
基于开源IM即时通讯框架MobileIMSDK:RainbowChat-iOS端v9.1版已发布
RainbowChat是一套基于开源IM聊天框架 MobileIMSDK 的产品级移动端IM系统。RainbowChat源于真实运营的产品,解决了大量的屏幕适配、细节优化、机器兼容问题
47 5
|
15天前
|
Swift iOS开发 开发者
探索iOS开发中的SwiftUI框架
【10月更文挑战第21天】在苹果生态系统中,SwiftUI的引入无疑为iOS应用开发带来了革命性的变化。本文将通过深入浅出的方式,带领读者了解SwiftUI的基本概念、核心优势以及如何在实际项目中运用这一框架。我们将从一个简单的例子开始,逐步深入到更复杂的应用场景,让初学者能够快速上手,同时也为有经验的开发者提供一些深度使用的技巧和策略。
42 1
|
3天前
|
存储 数据可视化 Swift
探索iOS开发之旅:从新手到专家
【10月更文挑战第33天】在这篇文章中,我们将一起踏上一场激动人心的iOS开发之旅。无论你是刚刚入门的新手,还是已经有一定经验的开发者,这篇文章都将为你提供宝贵的知识和技能。我们将从基础的iOS开发概念开始,逐步深入到更复杂的主题,如用户界面设计、数据存储和网络编程等。通过阅读这篇文章,你将获得成为一名优秀iOS开发者所需的全面技能和知识。让我们一起开始吧!
|
4天前
|
移动开发 Java Android开发
探索Android与iOS开发的差异性与互联性
【10月更文挑战第32天】在移动开发的大潮中,Android和iOS两大平台各领风骚。本文将深入浅出地探讨这两个平台的开发差异,并通过实际代码示例,展示如何在各自平台上实现相似的功能。我们将从开发环境、编程语言、用户界面设计、性能优化等多个角度进行对比分析,旨在为开发者提供跨平台开发的实用指南。
23 0
|
1月前
|
Android开发 Swift iOS开发
探索安卓与iOS开发的差异:从代码到用户体验
【10月更文挑战第5天】在移动应用开发的广阔天地中,安卓和iOS两大平台各占半壁江山。它们在技术架构、开发环境及用户体验上有着根本的不同。本文通过比较这两种平台的开发过程,揭示背后的设计理念和技术选择如何影响最终产品。我们将深入探讨各自平台的代码示例,理解开发者面临的挑战,以及这些差异如何塑造用户的日常体验。