AMapNaviDriveManager.h

Go to the documentation of this file.

//
//  AMapNaviDriveManager.h
//  AMapNaviKit
//
//  Created by 刘博 on 16/1/12.
//  Copyright © 2016年 Amap. All rights reserved.
//
 
#import "AMapNaviBaseManager.h"
#import "AMapNaviDriveDataRepresentable.h"
 
NS_ASSUME_NONNULL_BEGIN
 
@protocol AMapNaviDriveManagerDelegate;
 
#pragma mark - AMapNaviDriveManager
 
@interface AMapNaviDriveManager : AMapNaviBaseManager
 
#pragma mark - Singleton
 
+ (AMapNaviDriveManager *)sharedInstance;
 
+ (BOOL)destroyInstance;
 
- (instancetype)init __attribute__((unavailable("since 5.4.0 init 已被禁止使用，请使用单例 [AMapNaviDriveManager sharedInstance] 替代，且在调用类的 dealloc 函数里或其他适当时机(如导航ViewController被pop时)，调用 [AMapNaviDriveManager destroyInstance] 来销毁单例（需要注意如未销毁成功，请检查单例是否被强引用)")));
 
#pragma mark - Delegate
 
@property (nonatomic, weak) id<AMapNaviDriveManagerDelegate> delegate;
 
#pragma mark - Event Listener
 
- (void)addEventListener:(id<AMapNaviDriveManagerDelegate>)aListener;
 
- (void)removeEventListener:(id<AMapNaviDriveManagerDelegate>)aListener;
 
#pragma mark - Data Representative
 
- (void)addDataRepresentative:(id<AMapNaviDriveDataRepresentable>)aRepresentative;
 
- (void)removeDataRepresentative:(id<AMapNaviDriveDataRepresentable>)aRepresentative;
 
#pragma mark - Navi Route
 
@property (nonatomic, readonly) NSInteger naviRouteID;
 
@property (nonatomic, readonly, nullable) AMapNaviRoute *naviRoute;
 
@property (nonatomic, readonly, nullable) NSArray<NSNumber *> *naviRouteIDs;
 
@property (nonatomic, readonly, nullable) NSDictionary<NSNumber *, AMapNaviRoute *> *naviRoutes;
 
- (BOOL)selectNaviRouteWithRouteID:(NSInteger)routeID;
 
- (void)switchParallelRoad:(AMapNaviParallelRoadInfo *)parallelRoadInfo;
 
- (void)setMultipleRouteNaviMode:(BOOL)multipleRouteNaviMode;
 
- (void)setTruckMultipleRouteNaviMode:(BOOL)multipleRouteNaviMode;
 
#pragma mark - Options
 
@property (nonatomic, assign) BOOL updateCameraInfo;
 
@property (nonatomic, assign) BOOL updateTrafficInfo;
 
@property (nonatomic, assign) AMapNaviDetectedMode detectedMode;
 
@property (nonatomic, assign, readonly) AMapNaviGPSSignalStrength gpsSignalStrength;
 
@property (nonatomic, assign) NSUInteger gpsWeakDetecedInterval __attribute__((deprecated("已废弃，since 7.8.0")));
 
- (void)setIsOpenTrafficLight:(NSString *)key;
 
#pragma mark - Calculate Route
 
// 以下算路方法需要高德坐标(GCJ02)
 
- (BOOL)calculateDriveRouteWithEndPoints:(NSArray<AMapNaviPoint *> *)endPoints
                               wayPoints:(nullable NSArray<AMapNaviPoint *> *)wayPoints
                         drivingStrategy:(AMapNaviDrivingStrategy)strategy;
 
- (BOOL)calculateDriveRouteWithStartPoints:(NSArray<AMapNaviPoint *> *)startPoints
                                 endPoints:(NSArray<AMapNaviPoint *> *)endPoints
                                 wayPoints:(nullable NSArray<AMapNaviPoint *> *)wayPoints
                           drivingStrategy:(AMapNaviDrivingStrategy)strategy;
 
- (BOOL)calculateDriveRouteWithStartPointPOIId:(nullable NSString *)startPOIId
                                 endPointPOIId:(nonnull NSString *)endPOIId
                                wayPointsPOIId:(nullable NSArray<NSString *> *)wayPOIIds
                               drivingStrategy:(AMapNaviDrivingStrategy)strategy;
- (BOOL)calculateDriveRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
                                 endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
                                wayPOIInfos:(nullable NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
                            drivingStrategy:(AMapNaviDrivingStrategy)strategy;
 
- (BOOL)independentCalculateDriveRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
                                            endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
                                           wayPOIInfos:(nullable NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
                                       drivingStrategy:(AMapNaviDrivingStrategy)strategy
                                              callback:(nullable void (^)(AMapNaviRouteGroup *_Nullable routeGroup, NSError *_Nullable error))callback;
- (BOOL)recalculateDriveRouteWithDrivingStrategy:(AMapNaviDrivingStrategy)strategy;
 
#pragma mark - Manual
 
- (void)setVehicleProvince:(NSString *)province number:(NSString *)number __attribute__((deprecated("已废弃，请使用 setVehicleInfo: 替代，since 6.0.0")));
 
- (BOOL)setVehicleInfo:(nullable AMapNaviVehicleInfo *)vehicleInfo;
 
- (BOOL)setBroadcastMode:(AMapNaviBroadcastMode)mode;
 
- (BOOL)setOnlineCarHailingType:(AMapNaviOnlineCarHailingType)type;
 
#pragma mark - Traffic Status
 
- (nullable NSArray<AMapNaviTrafficStatus *> *)getTrafficStatusesWithStartPosition:(int)startPosition distance:(int)distance;
 
- (nullable NSArray<AMapNaviTrafficStatus *> *)getTrafficStatuses;
 
#pragma mark - Xcode Simulate Location
 
- (void)setXcodeSimulateLocationEnable:(BOOL)enableNavi __attribute__((deprecated("已废弃，since 7.5.0")));
 
#pragma mark - 服务区详情信息
- (void)setServiceAreaDetailsEnable:(BOOL)enable;
 
#pragma mark - push路线相关
 
- (BOOL)pushDriveRouteWithRouteGuideData:(nonnull NSData *)routeData
                            startPOIInfo:(nonnull AMapNaviPOIInfo *)startPOIInfo
                              endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
                             wayPOIInfos:(nullable NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
                         drivingStrategy:(AMapNaviDrivingStrategy)strategy;
 
// 5.1 算路协议升级后的路线还原接口 routeguide 协议版本号 since 9.0.0
- (NSString *_Nullable)getPushDataNaviVersion;
 
- (NSString *_Nullable)routeSDKVersion;
 
- (NSString *_Nullable)routeServerVersion;
@end
 
#pragma mark - Escort
 
@interface AMapNaviDriveManager (Escort)
 
- (BOOL)setEscortMissonID:(NSNumber *)missonID;
 
@end
 
#pragma mark - Private
 
@interface AMapNaviDriveManager (Private)
+ (BOOL)setCustomCloudControlEnable:(BOOL)enable;
- (BOOL)setExtenalCloudControl:(nullable NSString *)cloudControlString;
 
- (BOOL)getRestrictareaInfoInRoute:(AMapNaviRoute *)route callback:(nonnull void (^)(BOOL responseSuccess, NSString *responseData, NSString *errorDesc))callback;
 
@end
 
#pragma mark - AMapNaviDriveManagerDelegate
@protocol AMapNaviDriveManagerDelegate <NSObject>
@optional
- (void)driveManager:(AMapNaviDriveManager *)driveManager error:(NSError *)error;
 
- (void)driveManagerOnCalculateRouteSuccess:(AMapNaviDriveManager *)driveManager;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onCalculateRouteSuccessWithType:(AMapNaviRoutePlanType)type;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onCalculateRouteFailure:(NSError *)error;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onCalculateRouteFailure:(NSError *)error routePlanType:(AMapNaviRoutePlanType)type;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager didStartNavi:(AMapNaviMode)naviMode;
 
- (void)driveManagerNeedRecalculateRouteForYaw:(AMapNaviDriveManager *)driveManager;
 
- (void)driveManagerNeedRecalculateRouteForTrafficJam:(AMapNaviDriveManager *)driveManager;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onArrivedWayPoint:(int)wayPointIndex;
 
- (BOOL)driveManagerIsNaviSoundPlaying:(AMapNaviDriveManager *)driveManager;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager playNaviSoundString:(NSString *)soundString soundStringType:(AMapNaviSoundType)soundStringType;
 
- (void)driveManagerDidEndEmulatorNavi:(AMapNaviDriveManager *)driveManager;
 
- (void)driveManagerOnArrivedDestination:(AMapNaviDriveManager *)driveManager;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onNaviPlayRing:(AMapNaviRingType)ringType;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateGPSSignalStrength:(AMapNaviGPSSignalStrength)gpsSignalStrength;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager postRouteNotification:(AMapNaviRouteNotifyData *)notifyData;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onSuggestChangeMainNaviRoute:(AMapNaviSuggestChangeMainNaviRouteInfo *)suggestChangeMainNaviRouteInfo;
 
- (void)driveManager:(AMapNaviDriveManager *_Nullable)manager onUpdateDriveComfort:(AMapNaviDriveComfort *_Nonnull)driveComfort;
 
- (void)driveManager:(AMapNaviDriveManager *_Nullable)manager onUpdateDriveEvent:(AMapNaviDriveEvent *_Nonnull)driveEvent;
 
- (void)driveManager:(AMapNaviDriveManager *_Nullable)manager onUpdateNaviSpeedLimitSection:(NSInteger)speed;
@end
 
NS_ASSUME_NONNULL_END