BMKLocationManager.h

//
//  BMKLocationManager.h
//  BMKLocationKit
//
//  Created by baidu on 2017/3/2.
//  Copyright © 2017年 baidu. All rights reserved.
//

#import <Availability.h>
#import <Foundation/Foundation.h>
#import <CoreLocation/CoreLocation.h>
#import "BMKLocationReGeocode.h"
#import "BMKLocation.h"

typedef NS_ENUM(NSUInteger, BMKLocationCoordinateType)
{
    BMKLocationCoordinateTypeBMK09LL = 0,        
    BMKLocationCoordinateTypeBMK09MC,           
    BMKLocationCoordinateTypeWGS84,        
    BMKLocationCoordinateTypeGCJ02          
};

typedef NS_ENUM(int, BMKLocationNetworkState) {
    BMKLocationNetworkStateUnknown = 0,    
    BMKLocationNetworkStateWifi,           
    BMKLocationNetworkStateWifiHotSpot,          
    BMKLocationNetworkStateMobile2G,          
    BMKLocationNetworkStateMobile3G,          
    BMKLocationNetworkStateMobile4G        
    
};



FOUNDATION_EXPORT NSErrorDomain const _Nonnull BMKLocationErrorDomain;

typedef NS_ENUM(NSInteger, BMKLocationErrorCode)
{
    BMKLocationErrorUnKnown = 0,                   
    BMKLocationErrorLocFailed = 1,                 
    BMKLocationErrorDenied = 2,                    
    BMKLocationErrorNetWork = 3,                   
    BMKLocationErrorHeadingFailed = 4,             
    BMKLocationErrorGetExtraNetworkFailed  = 5,    
    BMKLocationErrorGetExtraParseFailed  = 6,      
    BMKLocationErrorFailureAuth  = 7,              
};

typedef NS_ENUM(NSInteger, BMKLAccuracyAuthorization) {
    
    BMKLAccuracyAuthorizationFullAccuracy,         
    BMKLAccuracyAuthorizationReducedAccuracy,      
};


typedef void (^BMKLocatingCompletionBlock)(BMKLocation * _Nullable location, BMKLocationNetworkState state , NSError * _Nullable error);



@protocol BMKLocationManagerDelegate;

#pragma mark - BMKLocationManager


@interface BMKLocationManager : NSObject

@property (nonatomic, weak, nullable) id<BMKLocationManagerDelegate> delegate;

@property(nonatomic, assign) CLLocationDistance distanceFilter;

@property(nonatomic, assign) CLLocationAccuracy desiredAccuracy;

@property(nonatomic, assign) CLActivityType activityType;

@property(nonatomic, assign) BMKLocationCoordinateType coordinateType;

@property(nonatomic, assign) BOOL pausesLocationUpdatesAutomatically;


@property(nonatomic, assign) BOOL allowsBackgroundLocationUpdates;

@property(nonatomic, assign) NSInteger locationTimeout;

@property(nonatomic, assign) NSInteger reGeocodeTimeout;

@property (nonatomic, assign) BOOL locatingWithReGeocode;

@property (nonatomic, assign) BOOL isNeedNewVersionReGeocode;


@property(nonatomic, copy, nullable) NSString * userID;

@property (nonatomic, readonly) BMKLAccuracyAuthorization accuracyAuthorization;


- (BOOL)requestLocationWithReGeocode:(BOOL)withReGeocode withNetworkState:(BOOL)withNetWorkState completionBlock:(BMKLocatingCompletionBlock _Nonnull)completionBlock;

- (void)startUpdatingLocation;

- (void)stopUpdatingLocation;

- (void)requestNetworkState;


+ (BOOL)headingAvailable;

- (void)startUpdatingHeading;

- (void)stopUpdatingHeading;

- (void)tryIndoorLocation;

- (void)stopIndoorLocation;


+ (CLLocationCoordinate2D) BMKLocationCoordinateConvert:(CLLocationCoordinate2D) coordinate SrcType:(BMKLocationCoordinateType)srctype DesType:(BMKLocationCoordinateType)destype;

+ (BOOL) BMKLocationDataAvailableForCoordinate:(CLLocationCoordinate2D)coordinate withCoorType:(BMKLocationCoordinateType)coortype;



- (CLAuthorizationStatus)authorizationStatus;


- (void)requestTemporaryFullAccuracyAuthorizationWithPurposeKey:(NSString * _Nonnull)purposeKey completion:(void(^ _Nullable)(NSError * _Nullable))completion API_AVAILABLE(ios(14.0));

- (void)requestTemporaryFullAccuracyAuthorizationWithPurposeKey:(NSString * _Nonnull)purposeKey API_AVAILABLE(ios(14.0));


@end

#pragma mark - BMKLocationManagerDelegate


@protocol BMKLocationManagerDelegate <NSObject>

@optional

- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager doRequestAlwaysAuthorization:(CLLocationManager * _Nonnull)locationManager;

- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager didFailWithError:(NSError * _Nullable)error;


- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager didUpdateLocation:(BMKLocation * _Nullable)location orError:(NSError * _Nullable)error;

- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager didChangeAuthorizationStatus:(CLAuthorizationStatus)status API_DEPRECATED_WITH_REPLACEMENT("-bmkLocationManagerDidChangeAuthorization", ios(4.2, 14.0));


- (void)BMKLocationManagerDidChangeAuthorization:(BMKLocationManager * _Nonnull)manager API_AVAILABLE(ios(14.0));


- (BOOL)BMKLocationManagerShouldDisplayHeadingCalibration:(BMKLocationManager * _Nonnull)manager;

- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager
          didUpdateHeading:(CLHeading * _Nullable)heading;

- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager
     didUpdateNetworkState:(BMKLocationNetworkState)state orError:(NSError * _Nullable)error;


@end