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"
#import "AMapNaviRoute.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 has been deprecated, please use the singleton [AMapNaviDriveManager sharedInstance] instead. And call [AMapNaviDriveManager destroyInstance] to destroy the singleton when calling the dealloc function of the class or at other appropriate times (such as when the navigation ViewController is popped).  (Note: If the destruction fails, check if the singleton is strongly referenced)")));
 
#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 - 轨迹还原
/*
 Designated latitude and longitude of navigation endpoint
 wayPoints - 途经点经纬度，同时支持最多16个途经点的路径规划；
 Longitude and latitude of waypoints, supporting path planning for up to 16 waypoints simultaneously;
TracePoints- 轨迹点经纬度，推荐使用高德算路结果中的经纬度点，最多40000个
 The latitude and longitude of the trajectory points are recommended to use the latitude and longitude points in the Gaode calculation results, with a maximum of 40000 points
vehicleType 0：燃油客车（默认值），1：燃油货车，2：纯电动客车（新能源标签默认值），3：纯电动货车，4：插电式混动客车，5：插电式混动货车，6：油车特种车辆，7：纯电动特种车辆，8：混动特种车辆，11：摩托车（油），12：摩托车（电），13：摩托车（混），17：柴油货车，18：施工作业车（定位合
 0: Fuel powered buses (default value), 1: Fuel powered trucks, 2: Pure electric buses (default value for new energy labels), 3: Pure electric trucks, 4: Plug in hybrid buses, 5: Plug in hybrid trucks, 6: Fuel powered special vehicles, 7: Pure electric special vehicles, 8: Hybrid special vehicles, 11: Motorcycles (gasoline), 12: Motorcycles (electric), 13: Motorcycles (hybrid), 17: Diesel trucks, 18: Construction work vehicles (positioning combined)
*/
+ (void)pushTrajectoryRestoration:(NSArray<AMapNaviPoint *> *)wayPoints tracePoints:(NSArray<AMapNaviPoint *> *)tracePoints vehicleType:(NSInteger)vehicleType drivingStrategy:(AMapNaviDrivingStrategy)drivingStrategy resultCallback:(void(^)(BOOL isLoadSuc))resultCallback;
 
#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 __attribute__((deprecated("Deprecated, since 10.0.820")));
 
@property (nonatomic, assign) BOOL updateTrafficInfo;
 
@property (nonatomic, assign) AMapNaviDetectedMode detectedMode;
 
@property (nonatomic, assign, readonly) AMapNaviGPSSignalStrength gpsSignalStrength;
 
@property (nonatomic, assign) NSUInteger gpsWeakDetecedInterval __attribute__((deprecated("Deprecated, since 7.8.0")));
 
- (void)setIsOpenTrafficLight:(NSString *)key;
 
#pragma mark - Calculate Route
 
// 以下算路方法需要高德坐标(GCJ02)
//The following routing methods require AutoNavi coordinates(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)calculateDriveRouteWithStartPOIInfos:(NSArray<AMapNaviPOIInfo *> *)startPOIInfos
                                 endPOIInfos:(NSArray<AMapNaviPOIInfo *> *)endPOIInfos
                                 wayPOIInfos:(nullable NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
                             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)calculateDriveRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
                                 endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
                                wayPOIInfos:(nullable NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
                            calRouteOptions:(nullable AMapNaviCalRouteOptions *)options;
 
- (BOOL)calculateDriveRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
                                 endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
                                wayPOIInfos:(nullable NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
                            drivingStrategy:(AMapNaviDrivingStrategy)strategy
                                  callback:(nullable void (^)(AMapNaviCalculateRouteResult *_Nullable routeResult))callback;
 
- (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)independentCalculateDriveRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
                                            endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
                                           wayPOIInfos:(nullable NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
                                       calRouteOptions:(nullable AMapNaviCalRouteOptions *)options
                                              callback:(nullable void (^)(AMapNaviRouteGroup *_Nullable routeGroup, NSError *_Nullable error))callback;
 
 
- (BOOL)recalculateDriveRouteWithDrivingStrategy:(AMapNaviDrivingStrategy)strategy;
 
- (BOOL)recalculateDriveRouteWithDrivingStrategy:(AMapNaviDrivingStrategy)strategy callback:(nullable void (^)(AMapNaviCalculateRouteResult *_Nullable routeResult))callback;
 
#pragma mark - Manual
 
- (void)setVehicleProvince:(NSString *)province number:(NSString *)number __attribute__((deprecated("Deprecated, please use setVehicleInfo: instead, 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("Deprecated, since 7.5.0")));
 
#pragma mark - 服务区详情信息 Service area details
- (void)setServiceAreaDetailsEnable:(BOOL)enable;
 
#pragma mark - push路线相关 push route related
 
- (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
// 5.1 Route restoration interface after route calculation protocol upgrade routeguide protocol version number
- (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 onCalculateRouteSuccessWithType:(AMapNaviRoutePlanType)type calculateRouteResult:(AMapNaviCalculateRouteResult *)calculateRouteResult;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onCalculateRouteFailure:(NSError *)error;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onCalculateRouteFailure:(NSError *)error routePlanType:(AMapNaviRoutePlanType)type;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onCalculateRouteFailure:(NSError *)error routePlanType:(AMapNaviRoutePlanType)type calculateRouteResult:(AMapNaviCalculateRouteResult *)calculateRouteResult;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager didStartNavi:(AMapNaviMode)naviMode;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager didStopNavi:(BOOL)isStopped;
 
- (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;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onStartPlayPCMData:(nonnull AMapNaviPCMTask *)playTask;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onPlayPCMData:(nonnull AMapNaviPCMTask *)playTask;
 
- (void)driveManager:(AMapNaviDriveManager *)driveManager onPCMDataFinished:(nonnull AMapNaviPCMTask *)playTask;
 
@end
 
NS_ASSUME_NONNULL_END