在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,这里就不做详细介绍。
424
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
