screen_ios.git - Gitblit

New file
			@@ -0,0 +1,110 @@
			//
			// BMKLocationService.h
			// LocationComponent
			//
			// Created by Baidu on 3/28/14.
			// Copyright (c) 2014 baidu. All rights reserved.
			//

			#import <Foundation/Foundation.h>
			#import <BaiduMapAPI_Base/BMKUserLocation.h>
			@class CLLocation;
			/// 定位服务Delegate,调用startUserLocationService定位成功后，用此Delegate来获取定位数据
			@protocol BMKLocationServiceDelegate <NSObject>
			@optional
			/**
			*在将要启动定位时，会调用此函数
			*/
			- (void)willStartLocatingUser;

			/**
			*在停止定位后，会调用此函数
			*/
			- (void)didStopLocatingUser;

			/**
			*用户方向更新后，会调用此函数
			*@param userLocation 新的用户位置
			*/
			- (void)didUpdateUserHeading:(BMKUserLocation *)userLocation;

			/**
			*用户位置更新后，会调用此函数
			*@param userLocation 新的用户位置
			*/
			- (void)didUpdateBMKUserLocation:(BMKUserLocation *)userLocation;

			/**
			*定位失败后，会调用此函数
			*@param error 错误号
			*/
			- (void)didFailToLocateUserWithError:(NSError *)error;
			@end

			@interface BMKLocationService : NSObject

			/// 当前用户位置，返回坐标类型为当前设置的坐标类型
			@property (nonatomic, readonly) BMKUserLocation *userLocation;

			/// 定位服务Delegate,调用startUserLocationService定位成功后，用此Delegate来获取定位数据
			@property (nonatomic, weak) id<BMKLocationServiceDelegate> delegate;

			/**
			*打开定位服务
			*需要在info.plist文件中添加(以下二选一，两个都添加默认使用NSLocationWhenInUseUsageDescription)：
			*NSLocationWhenInUseUsageDescription 允许在前台使用时获取GPS的描述
			*NSLocationAlwaysUsageDescription 允许永远可获取GPS的描述
			*/
			-(void)startUserLocationService;
			/**
			*关闭定位服务
			*/
			-(void)stopUserLocationService;

			#pragma mark - 定位参数，具体含义可参考CLLocationManager相关属性的注释

			/// 设定定位的最小更新距离。默认为kCLDistanceFilterNone
			@property(nonatomic, assign) CLLocationDistance distanceFilter;

			/// 设定定位精度。默认为kCLLocationAccuracyBest。
			@property(nonatomic, assign) CLLocationAccuracy desiredAccuracy;

			/// 设定最小更新角度。默认为1度，设定为kCLHeadingFilterNone会提示任何角度改变。
			@property(nonatomic, assign) CLLocationDegrees headingFilter;

			/// 指定定位是否会被系统自动暂停。默认为YES。只在iOS 6.0之后起作用。
			@property(nonatomic, assign) BOOL pausesLocationUpdatesAutomatically;

			///指定定位：是否允许后台定位更新。默认为NO。只在iOS 9.0之后起作用。设为YES时，Info.plist中 UIBackgroundModes 必须包含 "location"
			@property(nonatomic, assign) BOOL allowsBackgroundLocationUpdates;


			#pragma mark - 废弃接口
			/**
			* 2.9.0起废弃（使用distanceFilter属性替换），空实现
			*
			*在打开定位服务前设置
			*指定定位的最小更新距离(米)，默认：kCLDistanceFilterNone
			*/
			+ (void)setLocationDistanceFilter:(CLLocationDistance) distanceFilter __deprecated_msg("废弃方法（空实现），使用distanceFilter属性替换");
			/**
			* 2.9.0起废弃（使用distanceFilter属性替换），空实现
			*
			*获取当前定位的最小更新距离(米)
			*/
			+ (CLLocationDistance)getCurrentLocationDistanceFilter __deprecated_msg("废弃方法（空实现），使用distanceFilter属性替换");
			/**
			* 2.9.0起废弃（使用desiredAccuracy属性替换），空实现
			*
			*在打开定位服务前设置
			*设置定位精确度，默认：kCLLocationAccuracyBest
			*/
			+ (void)setLocationDesiredAccuracy:(CLLocationAccuracy) desiredAccuracy __deprecated_msg("废弃方法（空实现），使用desiredAccuracy属性替换");
			/**
			* 2.9.0起废弃（使用desiredAccuracy属性替换），空实现
			*
			*获取当前定位精确度
			*/
			+ (CLLocationAccuracy)getCurrentLocationDesiredAccuracy __deprecated_msg("废弃方法（空实现），使用desiredAccuracy属性替换");

			@end