111 lines
3.8 KiB
Objective-C
111 lines
3.8 KiB
Objective-C
//
|
||
// 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
|