//
//  AMapNaviRideDataRepresentable.h
//  AMapNaviKit
//
//  Created by liubo on 9/19/16.
//  Copyright © 2016 Amap. All rights reserved.
//

#import "AMapNaviCommonObj.h"

NS_ASSUME_NONNULL_BEGIN

@class AMapNaviInfo;
@class AMapNaviRoute;
@class AMapNaviLocation;
@class AMapNaviStatisticsInfo;
@class AMapNaviRideManager;

/**
 * @brief AMapNaviRideDataRepresentable协议.实例对象可以通过实现该协议,并将其通过 AMapNaviRideManager 的addDataRepresentative:方法进行注册,便可获取导航过程中的导航数据更新.
 * AMapNaviRideDataRepresentable Protocol. Instance objects can implement this protocol and register it through the addDataRepresentative: method of AMapNaviRideManager to receive navigation data updates during the navigation process.
 * 可以根据不同需求,选取使用特定的数据进行导航界面自定义.
 * The navigation interface can be customized by selecting specific data according to different needs.
 * AMapNaviRideView 即通过该协议实现导航过程展示.也可以依据导航数据的更新进行其他的逻辑处理.
 * AMapNaviRideView displays the navigation process through this protocol. Other logic processing can also be performed based on the update of navigation data.
 */
@protocol AMapNaviRideDataRepresentable <NSObject>

@optional

/**
 * @brief 导航模式更新回调
 * Navigation mode update callback
 * @param rideManager 骑行导航管理类
 * Cycling Navigation Management class
 * @param naviMode 导航模式,参考 AMapNaviMode 值
 * Navigation mode, refer to AMapNaviMode value
 */
- (void)rideManager:(AMapNaviRideManager *)rideManager updateNaviMode:(AMapNaviMode)naviMode;

/**
 * @brief 路径ID更新回调. 注意：请不要在此回调中调用 -selectNaviRouteWithRouteID: 接口，否则会出现死循环调用.
 * Route ID update callback. Note: Please do not call the -selectNaviRouteWithRouteID: interface in this callback, otherwise it will cause an infinite loop call.
 * @param rideManager 骑行导航管理类
 * Cycling Navigation Management class
 * @param naviRouteID 导航路径ID
 * Navigation Path ID
 */
- (void)rideManager:(AMapNaviRideManager *)rideManager updateNaviRouteID:(NSInteger)naviRouteID;

/**
 * @brief 路径信息更新回调. 注意：请不要在此回调中调用 -selectNaviRouteWithRouteID: 接口，否则会出现死循环调用.
 * Path Information Update Callback.  Note: Please do not call the -selectNaviRouteWithRouteID: interface in this callback, otherwise it will cause an infinite loop call.
 * @param rideManager 骑行导航管理类
 * Cycling Navigation Management class
 * @param naviRoute 路径信息,参考 AMapNaviRoute 类
 * Path Information, refer to AMapNaviRoute class
 */
- (void)rideManager:(AMapNaviRideManager *)rideManager updateNaviRoute:(nullable AMapNaviRoute *)naviRoute;

/**
 * @brief 导航信息更新回调
 * Navigation Information Update Callback
 * @param rideManager 骑行导航管理类
 * Cycling Navigation Management class
 * @param naviInfo 导航信息,参考 AMapNaviInfo 类
 * Navigation Information, refer to AMapNaviInfo class
 */
- (void)rideManager:(AMapNaviRideManager *)rideManager updateNaviInfo:(nullable AMapNaviInfo *)naviInfo;

/**
 * @brief 自车位置更新回调
 * Self-Vehicle Position Update Callback
 * @param rideManager 骑行导航管理类
 * Cycling Navigation Management class
 * @param naviLocation 自车位置信息,参考 AMapNaviLocation 类
 * Self-Vehicle Position Information, refer to AMapNaviLocation class
 */
- (void)rideManager:(AMapNaviRideManager *)rideManager updateNaviLocation:(nullable AMapNaviLocation *)naviLocation;

@end

NS_ASSUME_NONNULL_END