Core Location Framework学习
2014-01-23 18:34 三戒1993 阅读(140) 评论(0) 编辑 收藏 举报在Apple开发中,尤其是移动设备开发,经常会使用Core Location Framework,这个框架可以使得iOS设备获取当前的地理位置。本文就具体到Core Location 框架中,查看其声明源码。
CLHeading.h
代表了一个可以通过(x,y,z)三维空间坐标确定磁北极位置的向量。精确的Heading(方位)定位,同时也需要时间信息(即通过空间加时间四维坐标来确定位置)
typedef double CLHeadingComponentValue;
- 代表一个地理磁场数据类型,以微特斯拉为单位,在三维空间确定设备的坐标。
extern const CLLocationDegrees kCLHeadingFilterNone
- CLLocationManager用作为方位信息的过滤标志,表明不需要过滤最小移动量,用户的任何移动都会被通知。
@property(readonly, nonatomic) CLLocationDirection magneticHeading;
- 以度数来代表方向,0度代表磁北极方位,方向是参照设备的上部方向,不考虑设备的摆放方向,也不考虑用户的面对方向。
- 度数的范围为0~359.9
@property(readonly, nonatomic) CLLocationDirection trueHeading;
- 以度数来代表方向,0度表示真正的北极方向,方向是参照设备的上部方向,不考虑设备的摆放方向,也不考虑用户的面对方向。
- 度数的范围是0~359.9
- 众所周知,磁北极方向和地球北极方向是不重合的,所以,这里有必要区分magnetHeading和trueHeading.
@property(readonly, nonatomic) CLLocationDirection headingAccuracy;
- 代表了magnetHeading(磁北极方向)和真正的trueHeading(地理北极)在以度为度量单位上的最大偏差。不能取负值。
@property(readonly, nonatomic) CLHeadingComponentValue x;
@property(readonly, nonatomic) CLHeadingComponentValue y;
@property(readonly, nonatomic) CLHeadingComponentValue z;
@property(readonly, nonatomic) NSDate *timestamp;
- 分别代表了三维空间位置坐标和时间坐标。
CLLocation.h
代表带有精度和时间信息的地理坐标。
typedef double CLLocationDegrees;
- 以WGS84(World Geodetic System一1984 Coordinate System)坐标系统为基础,以度为单位,代表了经度或者纬度的类型。
- 度数可以是正的,代表了北方和东方;或者为负值,代表了南方和西方。
typedef double CLLocationAccuracy;
- 用来代表以米为单位的位置精度类型,越低的值,代表越精确的位置信息,不允许负值。
typedef double CLLocationSpeed;
- 代表了设备以m/s为单位的移动速度类型。
typedef double CLLocationDirection;
- 定义了以度为单位的方向类型,取值范围为0~359.9,不允许负值。
typedef struct {
CLLocationDegrees latitude;
CLLocationDegrees longitude;
} CLLocationCoordinate2D;
- 定义了二位的平面坐标系,以经度和纬度为坐标方向。
typedef double CLLocationDistance;
- 定义了以米为单位的距离类型。
extern const CLLocationDistance kCLDistanceFilterNone;
- 定义CLLocationManager中使用的距离过滤器,表明定位服务是否过滤最小移动距离,如果不过滤,用户的任何移动都会被通知。
extern const CLLocationAccuracy kCLLocationAccuracyBestForNavigation;
extern const CLLocationAccuracy kCLLocationAccuracyBest;
extern const CLLocationAccuracy kCLLocationAccuracyNearestTenMeters;
extern const CLLocationAccuracy kCLLocationAccuracyHundredMeters;
extern const CLLocationAccuracy kCLLocationAccuracyKilometer;
extern const CLLocationAccuracy kCLLocationAccuracyThreeKilometers;
- 定义定位精度枚举,更精确级别的定位对移动设备意味着更多的能耗和时间,所以对于应用需要的精度,选择合适的定位精度。
extern const CLLocationDistance CLLocationDistanceMax;
*用来指定设备支持的最长距离。
extern const NSTimeInterval CLTimeIntervalMax;
- 用来指定设备支持的最大时间跨度。
extern const CLLocationCoordinate2D kCLLocationCoordinate2DInvalid;
- 用来指定非法的二维坐标。
BOOL CLLocationCoordinate2DIsValid(CLLocationCoordinate2D coord);
- 用来判断一个二维坐标是否合法。
CLLocationCoordinate2D CLLocationCoordinate2DMake(CLLocationDegrees latitude, CLLocationDegrees longitude);
- 使用经度和纬度值来创建一个二维坐标。
-(id)initWithLatitude:(CLLocationDegrees)latitude longitude:(CLLocationDegrees)longitude;
- 使用经度和纬度来初始化一个CLLocation类型。
-(id)initWithCoordinate:(CLLocationCoordinate2D)coordinate altitude:(CLLocationDistance)altitude horizontalAccuracy:(CLLocationAccuracy)hAccuracy verticalAccuracy:(CLLocationAccuracy)vAccuracy timestamp:(NSDate *)timestamp;
- 使用经度纬度,及在水平和竖直方向的精度、时间戳来初始化 一个CLLocation实例
-(id)initWithCoordinate:(CLLocationCoordinate2D)coordinate altitude:(CLLocationDistance)altitude horizontalAccuracy:(CLLocationAccuracy)hAccuracy verticalAccuracy:(CLLocationAccuracy)vAccuracy course:(CLLocationDirection)course speed:(CLLocationSpeed)speed timestamp:(NSDate *)timestamp;
@property(readonly, nonatomic) CLLocationCoordinate2D coordinate;
- 返回当前的二维位置信息,即经度和纬度。
@property(readonly, nonatomic) CLLocationDistance altitude;
- 返回当前的距离,正值表示海平面以上的距离,负值表示海平面以下的距离
@property(readonly, nonatomic) CLLocationAccuracy horizontalAccuracy;
- 返回当前的水平精度,负值表示当前纬度非法
@property(readonly, nonatomic) CLLocationAccuracy verticalAccuracy;
- 返回当前的垂直精度,负值表示经度非法。
@property(readonly, nonatomic) CLLocationDirection course ;
- 返回相对地理北极的偏度,取值范围在0~359.9,负值非法。
@property(readonly, nonatomic) CLLocationSpeed speed;
- 返回当前设备的移动速度。
@property(readonly, nonatomic) NSDate *timestamp;
- 返回当前位置点的定位时间。
-(CLLocationDistance)distanceFromLocation:(const CLLocation *)location;
- 返回两个位置间的横向位置(应当是欧氏距离吧)。
CLRegion.h
定义了区域类型,但在现在的版本中,只支持圆形区域(是通过区域中心坐标和区域半径实现)。区域半径以米为单位。
-(id)initCircularRegionWithCenter:(CLLocationCoordinate2D)center radius:(CLLocationDistance)radius identifier:(NSString *)identifier;
- 使用区域原点,区域半径 和区域标志来初始化一个区域实例。
@property (readonly, nonatomic) CLLocationCoordinate2D center ;
@property (readonly, nonatomic) CLLocationDistance radius ;
@property (readonly, nonatomic) NSString *identifier;
- 返回区域信息。
-(BOOL)containsCoordinate:(CLLocationCoordinate2D)coordinate ;
- 判断一个坐标点是否在该区域内部。
CLPlacemark.h
代表了一个地理位置上的地方信息,这些地区信息,可以是国家,州,城市和街道名称。
-(id)initWithPlacemark:(CLPlacemark *)placemark; * 使用一个地区信息来初始化。
@property (nonatomic, readonly) CLLocation *location;
- 返回这个地区信息的位置信息。
@property (nonatomic, readonly) CLRegion *region;
- 返回一个地区信息的区域位置
@property (nonatomic, readonly) NSDictionary *addressDictionary;
- 返回一个ABCreateStringWithAddressDictionary表示的地址字典类型。
@property (nonatomic, readonly) NSString *name; // eg. Apple Inc.
@property (nonatomic, readonly) NSString *thoroughfare; // street address, eg. 1 Infinite Loop
@property (nonatomic, readonly) NSString *subThoroughfare; // eg. 1
@property (nonatomic, readonly) NSString *locality; // city, eg. Cupertino
@property (nonatomic, readonly) NSString *subLocality; // neighborhood, common name, eg. Mission District
@property (nonatomic, readonly) NSString *administrativeArea; // state, eg. CA
@property (nonatomic, readonly) NSString *subAdministrativeArea; // county, eg. Santa Clara
@property (nonatomic, readonly) NSString *postalCode; // zip code, eg. 95014
@property (nonatomic, readonly) NSString *ISOcountryCode; // eg. US
@property (nonatomic, readonly) NSString *country; // eg. United States
@property (nonatomic, readonly) NSString *inlandWater; // eg. Lake Tahoe
@property (nonatomic, readonly) NSString *ocean; // eg. Pacific Ocean
@property (nonatomic, readonly) NSArray *areasOfInterest; // eg. Golden Gate Park
- 以上为地址信息。
CLGeocoder.h
地理位置编码器。
typedef void (^CLGeocodeCompletionHandler)(NSArray *placemarks, NSError *error);
- 定义地理编码处理器。
@property (nonatomic, readonly, getter=isGeocoding) BOOL geocoding;
- 判断是否在进行位置编码。
-(void)reverseGeocodeLocation:(CLLocation *)location completionHandler:(CLGeocodeCompletionHandler)completionHandler;
- 翻转解码请求。地理解码是通过地址信息,解析出定位坐标,而这里是通过定位坐标解析出placemark。
-(void)geocodeAddressDictionary:(NSDictionary *)addressDictionary completionHandler:(CLGeocodeCompletionHandler)completionHandler; -(void)geocodeAddressString:(NSString *)addressString completionHandler:(CLGeocodeCompletionHandler)completionHandler ; -(void)geocodeAddressString:(NSString *)addressString inRegion:(CLRegion *)region completionHandler:(CLGeocodeCompletionHandler)completionHandler;
- 通过地址信息,和区域位置解析出定位坐标。
-(void)cancelGeocode;
- 取消当前解码请求。
CLLocationManager.h
位置管理器,用来接入定位服务。可以参照CLLocationManager Class Reference来了解该类的功能定义。
+(BOOL)locationServicesEnabled ; * 判断用户是否启动位置服务。 * 在启动位置更新操作之前,用户应当检查该方法的返回值来查看设备的位置服务是否启动。如果位置服务没有启动,而用户又启动了位置更新操作,那么Core Location 框架将会弹出一个让用户确认是否启动位置服务的对话框。
+(BOOL)headingAvailable;
- 如果设备支持方位服务(即设备能否返回方位数据)则返回YES,否则返回NO。
+(BOOL)significantLocationChangeMonitoringAvailable;
- 表明设备能否报告基于significant location changges的更新(significant location change监控,只是基于设备所链接的蜂窝塔的位置改变诊断,在精度要求不高的情况下,可以节省很多电量。)
+(BOOL)regionMonitoringAvailable;
- 表明设备是否支持区域监测,即使设备支持区域监测,用户也可能把当前应用设置为区域监测不可用,在启动或者初始化区域监测时应当检查。
+(CLAuthorizationStatus)authorizationStatus ;
- 检查应用的授权状态,应用在第一次启动时,会自动请求授权,应用应当明确被授权使用位置服务,并且位置服务当前出于运行状态,应用才能使用位置服务。
@property(assign, nonatomic) id delegate;
- 把位置管理的一些活动代理出去。
@property(assign, nonatomic) CLActivityType activityType ;
- 活动类型指明框架是否可以自动停止位置更新,这样当用户的位置很长时间没有改变时,系统可以暂停位置更新,来节省电能。
@property(assign, nonatomic) CLLocationDistance distanceFilter;
- 距离过滤,通过前后两次的位置信息来决定距离长度,当距离长度没有达到当前设定的distanceFilter时,不触发位置更新事件。
@property(assign, nonatomic) CLLocationAccuracy desiredAccuracy;
- 所需要的精度,应当根据应用场景来设置当前的最佳定位精度,更高的精度意味着在定位时将会消耗更多的能量和时间。定位服务可能不支持所设定的精度,但定位服务将会最大可能的满足所设定的精度。
@property(assign, nonatomic) BOOL pausesLocationUpdatesAutomatically ;
- 是否可以自动暂停位置更新操作。
@property(readonly, nonatomic) CLLocation *location;
- 上次接收到的位置信息。
@property(assign, nonatomic) CLLocationDegrees headingFilter ;
- 指定产生heading事件时的最小角度改变量。默认的最小headingFilter值为1度。
@property(assign, nonatomic) CLDeviceOrientation headingOrientation ;
- 指定设备的方位朝向参照方向,默认是参照设备的向上方向,但如果应用的布局方向在其他方向上,那么通过设置headingOrientation可以指定heading的参照方向。
@property(readonly, nonatomic) CLHeading *heading;
*返回最近一次的方位信息。
@property (readonly, nonatomic) CLLocationDistance maximumRegionMonitoringDistance;
- 检测区域的最大范围。这个值可能依赖于设备的硬件特性,当给出比该值更大的区域范围时,将会产生kCLErrorRegionMonitoringFailure
@property (readonly, nonatomic) NSSet *monitoredRegions;
- 当前正在监测的区域集合。不能直接把监测区域添加到该集合中,应当使用startMonitoringForRegion:desiredAccuracy:方法来增加想要监测的区域。
-(void)startUpdatingLocation;
-(void)stopUpdatingLocation;
-(void)startUpdatingHeading ;
-(void)stopUpdatingHeading ;
-(void)dismissHeadingCalibrationDisplay ;
-(void)startMonitoringSignificantLocationChanges ;
-(void)stopMonitoringSignificantLocationChanges;
- 以上方法为开启或者停止相应的服务。
-(void)stopMonitoringForRegion:(CLRegion *)region ;
-(void)startMonitoringForRegion:(CLRegion *)region ;
-(void)startMonitoringForRegion:(CLRegion *)region desiredAccuracy:(CLLocationAccuracy)accuracy ;
- 以指定的精度添加需要监测的区域,应用将要自己负责检测这些区域边界是否有重合的部分,来防止当用户在使用这些重合区域时而发出的重复的通知。如果有相同标记的区域已经出于被监控的状态,则从监控列表中移除该区域。操作的异步性可能导致区域不能立即处于被监控状态。
-(void)allowDeferredLocationUpdatesUntilTraveled:(CLLocationDistance)distance timeout:(NSTimeInterval)timeout ;
- 设定应用的位置更新处理的延迟时间,这样可以使设备处于低能耗状态。如果应用是在前台运行,LocationManagerDelegate仍会持续的接收到位置更新的请求,但是应用在后台处理时,则会使用此处设置的延迟时间,以节省设备的电能。
-(void)disallowDeferredLocationUpdates;
- 如果之前有设置enabled 那么则取消延迟位置更新的允许。
+(BOOL)deferredLocationUpdatesAvailable ;
- 表明设备是否支持延迟更新。
CLLocationManagerDelegate.h
-(void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray *)locations ;
- 告知代理,新位置已经可以使用了,尽管这个方法实现在协议中是可选的,但最好实现它。
-(void)locationManager:(CLLocationManager *)manager didUpdateHeading:(CLHeading *)newHeading ;
*告知代理,方位信息已经被位置管理器更新,如果位置管理器有使用startUpdateingHeading这个方法,则应当实现本方法。
-(BOOL)locationManagerShouldDisplayHeadingCalibration:(CLLocationManager *)manager;
- 询问代理是否方位校准警告是否需要显示,当有新的Heading信息时调用该方法,如否有需要显示Heading校准信息,则返回YES
-(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:(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:(NSError *)error ;
- 告知代理,以上事件有发生,以便做相应处理。
使用LocationManager
//Standard Location Service
//----------------------
Create a new location manager
locationManager = [[CLLocationManager alloc] init];
// Set Location Manager delegate
[locationManager setDelegate:self];
// Set location accuracy levels
[locationManager setDesiredAccuracy:kCLLocationAccuracyKilometer];
// Update again when a user moves distance in meters
[locationManager setDistanceFilter:500];
// Configure permission dialog
[locationManager setPurpose:@"My Custom Purpose Message..."];
// Start updating location
[locationManager startUpdatingLocation];
更多如何使用CLLocationManager指导,请参见iOS 5 Core Frameworks: Core Location and Map Kit,这里就不做详细介绍。