手把手教你封装一个获取定位的管理类
2017-02-22 本文已影响108人
再见远洋
源码地址
直接上重点，先把地址放出来，比较着急的，可以直接拿取用，传送门：https://github.com/wxh794708907/YJYYLocationManager
前言
首先说说为什么要封装这个，我记得我做的前几个项目中都用到了获取用户定位的功能，当时是基于百度地图或者是高德地图来做的，所以当时并没有涉及到自己去封装一个管理类的想法，目前在做的项目中由于没有继承百度地图/高德地图但是需要用到用户定位、用户和主播之间的距离、用户城市等信息，因此特意封装了一个获取定位、计算两个坐标距离等功能的管理类，防止以后再用到时都写重复的代码。顺便带着不熟悉CoreLocation框架的简友们一起来封装一个工具类。
CoreLocation的使用
封装之前我们还是来看看不封装时CoreLocation怎么用的，如果不会用那封装就不用说了，不过这篇文章我不想再谈CoreLocation的使用，因为我在很久以前写过一篇文章专门来介绍CoreLocation的使用，所以如果各位看官不熟悉CoreLocation使用的，先去看看我以前的文章介绍。传送门:http://www.jianshu.com/p/a0ba17eda84e
封装第一步 接口的定制
无论是封装什么工具类，第一步我觉得是考虑好自己的需求，需要做什么，然后再根据需求来定制接口，就以我们今天的需求来说，我们是需要获取用户的地理位置，那么我们定制接口的时候肯定是需要有经纬度或者地名之类的参数或者返回值，考虑到使用的简便和获取定位的异步性，这里我们使用block的形式来做，接口定义如下：
/**
创建地理位置管理单例
@return 返回地理位置管理单例
*/
+ (instancetype)sharedManager;
/**
更新地理位置
@param locationCB 定位成功回调
*/
- (void)updateLocationWithLocation:(void(^)(CLLocation *location))locationCB failureCB:(void(^)(NSError *error))failureCB;
/**
传入经纬度返回地名
@param location location
@param callBack 反编码成功回调
*/
- (void)reverseGeocodeLocation:(CLLocation *)location callBack:(void(^)(NSString * place))callBack;
/**
获取定位后反编码之后用户位置
@param callBack 反编码成功之后的回调
*/
- (void)updateReverseGeocodeLocation:(void(^)(NSString *placeName))callBack;
/**
更新速度信息
@param callBack 速度变化回调
*/
-(void)updateSpeedWithCallBack:(void(^)(CLLocationSpeed speed)) callBack;
/**
计算相对距离(km)
@param startCoordinate 起点
@param targetCoordinate 目标位置
@return 相对距离
*/
-(CLLocationDistance)distanceFromCoordinate:(CLLocationCoordinate2D)startCoordinate
toTargetCoordinate:(CLLocationCoordinate2D) targetCoordinate;
/**
计算当前位置到目标位置的相对距离(km)
@param targetCoordinate 目标位置
*/
-(void)distanceFromCurrentLocationToTargetLocation:(CLLocationCoordinate2D) targetCoordinate callBack:(void(^)(CLLocationDistance distance))callBack;
当然这里我们还必须有管理单例的创建接口，此外我们在获取定位失败时也需要有回调，所以这里我们还加入了失败的回调。
封装第二部 接口的实现
接口的定制我们已经做完了，接下来就该来实现了，我们获取定位是根据苹果的代理回调来做的，但是我们在这个方法实现里是获取不到定位的，怎么办？添加全局属性来关联啊。具体实现如下：
#import "YJYYLocationManager.h"
#import <CoreLocation/CoreLocation.h>
typedef void(^YJYYLocationBlock)(CLLocation *location);
typedef void(^YJYYFailureBlock)(NSError *error);
typedef void(^YJYYReverseGeoBlock)(NSString *placeName);
typedef void(^YJYYSpeedBlock)(CLLocationSpeed speed);
@interface YJYYLocationManager ()<CLLocationManagerDelegate>{
// 位置管理
CLLocationManager *_locationManager;
// 地理反编码
CLGeocoder *_geocoder;
}
/** 定位成功block */
@property(nonatomic,copy) YJYYLocationBlock locationBlock;
/** 定位失败block */
@property(nonatomic,copy) YJYYFailureBlock failureBlock;
/** 反编码成功block */
@property(nonatomic,copy) YJYYReverseGeoBlock reverseGeoBlcok;
/** 速度变化block */
@property(nonatomic,copy) YJYYSpeedBlock speedBlock;
@end
@implementation YJYYLocationManager
+ (instancetype)sharedManager {
static id _instance;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
_instance = [[self alloc] init];
});
return _instance;
}
- (instancetype)init {
if (self = [super init]) {
_geocoder = [[CLGeocoder alloc] init];
// 创建管理者
_locationManager = [[CLLocationManager alloc] init];
// 设置代理
_locationManager.delegate = self;
// 设置定位距离过滤参数 (当本次定位和上次定位之间的距离大于或等于这个值时，调用代理方法)
_locationManager.distanceFilter = 100 ;
// 设置定位精度(精度越高越耗电)
[_locationManager setDesiredAccuracy:kCLLocationAccuracyBest];
//版本适配 请求权限 iOS 8之后必须在plist中添加相应key
if ([_locationManager respondsToSelector:@selector(requestWhenInUseAuthorization)]) {
[_locationManager requestWhenInUseAuthorization];
}
//判断是否允许定位
if ([CLLocationManager locationServicesEnabled]) {
// 开启实时定位
[_locationManager startUpdatingLocation];
}
}
return self;
}
//获取用户定位
- (void)updateLocationWithLocation:(void (^)(CLLocation *location))locationCB failureCB:(void (^)(NSError *error))failureCB{
NSAssert(locationCB != nil, @"定位成功回调不能为空");
self.locationBlock = locationCB;
NSAssert(failureCB != nil, @"定位失败回调不能为空");
self.failureBlock = failureCB;
}
//反地理编码
- (void)reverseGeocodeLocation:(CLLocation *)location callBack:(void(^)(NSString * place))callBack{
[_geocoder reverseGeocodeLocation:location completionHandler:^(NSArray<CLPlacemark *> * _Nullable placemarks, NSError * _Nullable error) {
CLPlacemark * placemark = placemarks.firstObject;
if (callBack) {
callBack(placemark.name);
}
}];
}
//获取定位后再反编码
- (void)updateReverseGeocodeLocation:(void (^)(NSString *placeName))callBack {
NSAssert(callBack !=nil, @"反编码回调传入不能为空");
self.reverseGeoBlcok = callBack;
}
//用户速度回调
- (void)updateSpeedWithCallBack:(void (^)(CLLocationSpeed speed))callBack {
NSAssert(callBack !=nil, @"速度回调传入不能为空");
self.speedBlock = callBack;
}
//计算两坐标距离
- (CLLocationDistance)distanceFromCoordinate:(CLLocationCoordinate2D)startCoordinate toTargetCoordinate:(CLLocationCoordinate2D)targetCoordinate {
CLLocation *curtLocation = [[CLLocation alloc] initWithLatitude:startCoordinate.latitude longitude:startCoordinate.longitude];
CLLocation *targetLocation = [[CLLocation alloc] initWithLatitude:targetCoordinate.latitude longitude:targetCoordinate.longitude];
CLLocationDistance distance = [curtLocation distanceFromLocation:targetLocation];
return distance/1000.f;
}
//从当前位置到目标位置距离
- (void)distanceFromCurrentLocationToTargetLocation:(CLLocationCoordinate2D)targetCoordinate callBack:(void (^)(CLLocationDistance))callBack{
//先获取定位
[self updateLocationWithLocation:^(CLLocation *location) {
if (callBack) {
callBack([self distanceFromCoordinate:location.coordinate toTargetCoordinate:targetCoordinate]);
}
} failureCB:^(NSError *error) {
NSLog(@"抱歉获取定位失败");
}];
}
#pragma mark - 代理回调
#pragma mark -
/** 获取到新的位置信息时调用*/
-(void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray *)locations
{
//去除第一条数据
CLLocation * location = locations.firstObject;
__weak typeof(self) weakSelf = self;
//定位成功回调
if (self.locationBlock) {
self.locationBlock(locations.firstObject);
}
//反编码回调
if (self.reverseGeoBlcok) {
[self reverseGeocodeLocation:locations.firstObject callBack:^(NSString *place) {
weakSelf.reverseGeoBlcok(place);
}];
}
//速度回调
if (self.speedBlock) {
self.speedBlock(location.speed *3.6);
}
}
/** 不能获取位置信息时调用*/
-(void)locationManager:(CLLocationManager *)manager didFailWithError:(NSError *)error
{
if (self.failureBlock) {
NSLog(@"获取定位失败");
self.failureBlock(error);
}
}
@end
代码都有详细的注释 还是很清晰的，有什么不懂得可以留言
总结
封装一个工具类，我觉得核心思想就是明确自己需要的，然后根据想要的去定制接口 ，最后想办法来实现需求，当然除了作为一个工具类来说，就单单返回用户定位这一个方法肯定是不够的，我还提供了更加丰富的API在里面例如地理反编码（ 传入经纬度返回地名）、 获取定位后反编码之后用户位置、 更新速度信息等 具体可以查看代码或者看我的github地址。有需要的可以直接拿去用。哪里写的不好的地方也可以提出更好的建议。
