//
//  AMapNaviDriveDataRepresentable.h
//  AMapNaviKit
//
//  Created by 刘博 on 16/1/13.
//  Copyright © 2016年 Amap. All rights reserved.
//

#import "AMapNaviCommonObj.h"

NS_ASSUME_NONNULL_BEGIN

@class AMapNaviInfo;
@class AMapNaviRoute;
@class AMapNaviLocation;
@class AMapNaviStatisticsInfo;
@class AMapNaviDriveManager;

/**
 * @brief AMapNaviDriveDataRepresentable协议.实例对象可以通过实现该协议,并将其通过 AMapNaviDriveManager 的addDataRepresentative:方法进行注册,便可获取导航过程中的导航数据更新.
 * 可以根据不同需求,选取使用特定的数据进行导航界面自定义. 
 * AMapNaviDriveView 即通过该协议实现导航过程展示.也可以依据导航数据的更新进行其他的逻辑处理.
 */
@protocol AMapNaviDriveDataRepresentable <NSObject>
@optional

/**
 * @brief 导航模式更新回调. 从5.3.0版本起,算路失败后导航SDK只对外通知算路失败,SDK内部不再执行停止导航的相关逻辑.因此,当算路失败后,不会收到 driveManager:updateNaviMode: 回调; AMapNaviDriveManager.naviMode 不会切换到 AMapNaviModeNone 状态, 而是会保持在 AMapNaviModeGPS or AMapNaviModeEmulator 状态.
 * @param driveManager 驾车导航管理类
 * @param naviMode 导航模式,参考 AMapNaviMode 值
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateNaviMode:(AMapNaviMode)naviMode;

/**
 * @brief 路径ID更新回调. 注意：请不要在此回调中调用 -selectNaviRouteWithRouteID: 接口，否则会出现死循环调用.
 * @param driveManager 驾车导航管理类
 * @param naviRouteID 导航路径ID
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateNaviRouteID:(NSInteger)naviRouteID;

/**
 * @brief 路径信息更新回调. 注意：请不要在此回调中调用 -selectNaviRouteWithRouteID: 接口，否则会出现死循环调用.
 * @param driveManager 驾车导航管理类
 * @param naviRoute 路径信息,参考 AMapNaviRoute 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateNaviRoute:(nullable AMapNaviRoute *)naviRoute;

/**
 * @brief 导航信息更新回调
 * @param driveManager 驾车导航管理类
 * @param naviInfo 导航信息,参考 AMapNaviInfo 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateNaviInfo:(nullable AMapNaviInfo *)naviInfo;

/**
 * @brief 自车位置更新回调 (since 5.0.0，模拟导航和实时导航的自车位置更新都会走此回调)
 * @param driveManager 驾车导航管理类
 * @param naviLocation 自车位置信息,参考 AMapNaviLocation 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateNaviLocation:(nullable AMapNaviLocation *)naviLocation;

/**
 * @brief 需要显示路口放大图时的回调。注意：10.0.2版本开始，自定义View中如果设置了showCrossImage为YES，回调中crossImage为nil
 * @param driveManager 驾车导航管理类
 * @param crossImage 路口放大图Image(宽:高 = 25:16)
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager showCrossImage:(nullable UIImage *)crossImage;

/**
 * @brief 需要隐藏路口放大图时的回调。
 * @param driveManager 驾车导航管理类
 */
- (void)driveManagerHideCrossImage:(AMapNaviDriveManager *)driveManager;

/**
 * @brief 需要显示车道信息时的回调.可通过 UIImage *CreateLaneInfoImageWithLaneInfo(NSString *laneBackInfo, NSString *laneSelectInfo); 方法创建车道信息图片
 * 0-直行; 1-左转; 2-直行和左转; 3-右转;
 * 4-直行和右转; 5-左转掉头; 6-左转和右转; 7-直行和左转和右转;
 * 8-右转掉头; 9-直行和左转掉头; 10-直行和右转掉头; 11-左转和左转掉头;
 * 12-右转和右转掉头; 13-直行左侧道路变宽; 14-左转和左转掉头左侧变宽; 16-直行和左转和左掉头;
 * 17-右转和左掉头; 18-左转和左掉头和右转; 19-直行和右转和左掉头; 20-左转和右掉头; 21-公交车道; 23-可变车道;
 * 255-只会出现在laneSelectInfo，表示目前规划的路径，不可以走这个车道
 *
 * @param driveManager 驾车导航管理类
 * @param laneBackInfo 车道背景信息，例如：@"1|0|0|4"，表示当前道路有4个车道，分别为"左转|直行|直行|右转+直行"
 * @param laneSelectInfo 车道前景信息，其个数一定和车道背景信息一样，例如：@"255|0|0|0"，表示选择了当前道路的第2、3、4三个直行车道。
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager showLaneBackInfo:(NSString *)laneBackInfo laneSelectInfo:(NSString *)laneSelectInfo;

/**
 * @brief 需要隐藏车道信息时的回调
 * @param driveManager 驾车导航管理类
 */
- (void)driveManagerHideLaneInfo:(AMapNaviDriveManager *)driveManager;

/**
 * @brief 路况光柱信息更新回调
 * @param driveManager 驾车导航管理类
 * @param trafficStatus 路况光柱信息数组,参考 AMapNaviTrafficStatus 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateTrafficStatus:(nullable NSArray<AMapNaviTrafficStatus *> *)trafficStatus;

/**
 * @brief 电子眼信息更新回调 since 5.0.0
 * @param driveManager 驾车导航管理类
 * @param cameraInfos 电子眼信息,参考 AMapNaviCameraInfo 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateCameraInfos:(nullable NSArray<AMapNaviCameraInfo *> *)cameraInfos;

/**
 * @brief 服务区和收费站信息更新回调 since 5.0.0
 * @param driveManager 驾车导航管理类
 * @param serviceAreaInfos 服务区信息,参考 AMapNaviServiceAreaInfo 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateServiceAreaInfos:(nullable NSArray<AMapNaviServiceAreaInfo *> *)serviceAreaInfos;

/**
 * @brief 通知当前是否可以进行平行道路切换，包括主路、辅路以及高架桥上、高架桥下. since 5.3.0
 * @param driveManager 驾车导航管理类
 * @param parallelRoadStatus 平行道路信息,参考 AMapNaviParallelRoadStatus 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateParallelRoadStatus:(nullable AMapNaviParallelRoadStatus *)parallelRoadStatus;

/**
 * @brief 区间电子眼信息更新回调 since 6.0.0
 * @param driveManager 驾车导航管理类
 * @param state 自车位置和区间测速电子眼路段的位置关系,参考 AMapNaviIntervalCameraPositionState 类
 * @param startInfo 电子眼信息,参考 AMapNaviCameraInfo 类
 * @param endInfo 电子眼信息,参考 AMapNaviCameraInfo 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateIntervalCameraWithPositionState:(AMapNaviIntervalCameraPositionState)state startInfo:(nullable AMapNaviCameraInfo *)startInfo endInfo:(nullable AMapNaviCameraInfo *)endInfo;

/**
 * @brief 导航中的转向图标更新回调 since 6.2.0
 * @param driveManager 驾车导航管理类
 * @param turnIconImage 导航段转向图标, 默认大小为（255,255）
 * @param turnIconType 导航段转向图标类型,参考 AMapNaviIconType 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateTurnIconImage:(nullable UIImage *)turnIconImage turnIconType:(AMapNaviIconType)turnIconType;

/**
 * @brief 导航中相对于当前转向图标，下一个转向图标更新回调 since 6.9.0
 * @param driveManager 驾车导航管理类
 * @param turnIconImage 导航段下一个路口转向图标, 默认大小为（255,255）
 * @param turnIconType 导航段下一个转向图标类型,参考 AMapNaviIconType 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateNextTurnIconImage:(nullable UIImage *)turnIconImage nextTurnIconType:(AMapNaviIconType)turnIconType;

/**
 * @brief 多路线导航模式下的备选路线更新回调, 注意：此函数只有在 driveManager 设置了多路线导航模式才会回调. since 6.3.0
 * @param driveManager 驾车导航管理类
 * @param backupRoutes 备选路线信息数组, 参考 AMapNaviRoute 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateBackupRoute:(nullable NSArray<AMapNaviRoute *> *)backupRoutes;

/**
 * @brief 前方拥堵区域信息的更新回调. since 7.5.0
 * @param driveManager 驾车导航管理类
 * @param congestionInfo 拥堵区域信息, 参考 AMapNaviCongestionInfo 类，如果已通过该拥堵区域或者其不再拥堵时，congestionInfo会返回nil
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateCongestionInfo:(nullable AMapNaviCongestionInfo *)congestionInfo;

#pragma mark - 智能巡航

/**
 * @brief 巡航道路设施信息更新回调.该更新回调只有在detectedMode开启后有效
 * @param driveManager 驾车导航管理类
 * @param trafficFacilities 道路设施信息数组,参考 AMapNaviTrafficFacilityInfo 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateTrafficFacilities:(nullable NSArray<AMapNaviTrafficFacilityInfo *> *)trafficFacilities;

/**
 * @brief 巡航时自车前方电子眼信息.该更新回调只有在detectedMode开启后有效 since 6.7.0
 * @param driveManager 驾车导航管理类
 * @param cameraInfos 电子眼信息数组,参考 AMapNaviTrafficFacilityInfo 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateCruiseElecCameraInfos:(NSArray<AMapNaviTrafficFacilityInfo *> *)cameraInfos;

/**
 * @brief 巡航信息更新回调.该更新回调只有在detectedMode开启后有效
 * @param driveManager 驾车导航管理类
 * @param cruiseInfo 巡航信息,参考 AMapNaviCruiseInfo 类
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateCruiseInfo:(nullable AMapNaviCruiseInfo *)cruiseInfo;

/**
 * @brief 巡航状态下的拥堵区域信息. 该更新回调只有在detectedMode开启后有效 since 6.7.0
 * @param driveManager 驾车导航管理类
 * @param congestionInfo 巡航拥堵信息, 参考 AMapNaviCruiseCongestionInfo 类, 当前方无拥堵信息时, congestionInfo 的值为 nil .
 */
- (void)driveManager:(AMapNaviDriveManager *)driveManager updateCruiseCongestionInfo:(AMapNaviCruiseCongestionInfo *)congestionInfo;


@end

NS_ASSUME_NONNULL_END