439 lines
29 KiB
Objective-C
439 lines
29 KiB
Objective-C
//
|
||
// AMapNaviRideManager.h
|
||
// AMapNaviKit
|
||
//
|
||
// Created by liubo on 9/19/16.
|
||
// Copyright © 2016 Amap. All rights reserved.
|
||
//
|
||
|
||
#import "AMapNaviTravelManager.h"
|
||
#import "AMapNaviRideDataRepresentable.h"
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
@protocol AMapNaviRideManagerDelegate;
|
||
|
||
#pragma mark - AMapNaviRideManager
|
||
|
||
///骑行导航管理类
|
||
///Bike Navigation Management Class
|
||
@interface AMapNaviRideManager : AMapNaviTravelManager
|
||
|
||
#pragma mark - Singleton
|
||
|
||
/**
|
||
* @brief AMapNaviRideManager单例。注意：如果已经获取了AMapNaviDriveManager，需要调用destroyInstance方法销毁单例，再获取骑行导航单例。since 10.1.200。
|
||
* AMapNaviRideManager singleton. Note: If AMapNaviDriveManager has already been obtained, you need to call the destroyInstance method to destroy the singleton before obtaining the bike navigation singleton.
|
||
* @return AMapNaviRideManager实例
|
||
* AMapNaviRideManager instance
|
||
*/
|
||
+ (AMapNaviRideManager *)sharedInstance;
|
||
|
||
/**
|
||
* @brief 销毁AMapNaviRideManager单例. since 7.4.0
|
||
* Destroy AMapNaviRideManager singleton
|
||
* @return 是否销毁成功. 如果返回NO，请检查单例是否被强引用
|
||
* Whether the destruction was successful. If NO is returned, please check if the singleton is strongly referenced
|
||
*/
|
||
+ (BOOL)destroyInstance;
|
||
|
||
/**
|
||
* @brief 请使用单例替代. since 7.4.0 init已被禁止使用，请使用单例 [AMapNaviRideManager sharedInstance] 替代
|
||
* Please use singleton instead. Since 7.4.0, init has been deprecated, please use the singleton [AMapNaviRideManager sharedInstance] instead.
|
||
*/
|
||
- (instancetype)init __attribute__((unavailable("Since 7.4.0, init has been deprecated, please use the singleton [AMapNaviRideManager sharedInstance] instead")));
|
||
|
||
#pragma mark - Delegate
|
||
|
||
///实现了 AMapNaviRideManagerDelegate 协议的类指针
|
||
///Class pointer implementing the AMapNaviRideManagerDelegate protocol
|
||
@property (nonatomic, weak) id<AMapNaviRideManagerDelegate> delegate;
|
||
|
||
#pragma mark - Event Listener
|
||
|
||
/**
|
||
* @brief 增加用于接收导航回调事件的Listener, 效果等同于delegate. 注意:该方法不会增加实例对象的引用计数(Weak Reference). since 8.0.1
|
||
* Add a Listener to receive navigation callback events, which is equivalent to a delegate. Note: This method does not increase the reference count of the instance object (Weak Reference)
|
||
* @param aListener 实现了 AMapNaviRideManagerDelegate 协议的实例
|
||
* An instance that implements the AMapNaviRideManagerDelegate protocol
|
||
*/
|
||
- (void)addEventListener:(id<AMapNaviRideManagerDelegate>)aListener;
|
||
|
||
/**
|
||
* @brief 移除用于接收导航回调事件的Listener. since 8.0.1
|
||
* Remove the Listener used to receive navigation callback events
|
||
* @param aListener 实现了 AMapNaviRideManagerDelegate 协议的实例
|
||
* An instance that implements the AMapNaviRideManagerDelegate protocol
|
||
*/
|
||
- (void)removeEventListener:(id<AMapNaviRideManagerDelegate>)aListener;
|
||
|
||
#pragma mark - Data Representative
|
||
|
||
/**
|
||
* @brief 增加用于展示导航数据的DataRepresentative.注意:该方法不会增加实例对象的引用计数(Weak Reference)
|
||
* Add the DataRepresentative used to display navigation data. Note: This method will not increase the reference count of the instance object (Weak Reference)
|
||
* @param aRepresentative 实现了 AMapNaviRideDataRepresentable 协议的实例
|
||
* An instance that implements the AMapNaviRideDataRepresentable protocol
|
||
*/
|
||
- (void)addDataRepresentative:(id<AMapNaviRideDataRepresentable>)aRepresentative;
|
||
|
||
/**
|
||
* @brief 移除用于展示导航数据的DataRepresentative
|
||
* Remove the DataRepresentative used to display navigation data
|
||
* @param aRepresentative 实现了 AMapNaviRideDataRepresentable 协议的实例
|
||
* An instance that implements the AMapNaviRideDataRepresentable protocol
|
||
*/
|
||
- (void)removeDataRepresentative:(id<AMapNaviRideDataRepresentable>)aRepresentative;
|
||
|
||
#pragma mark - Navi Route
|
||
|
||
///当前导航路径的ID
|
||
///The ID of the current navigation path
|
||
@property (nonatomic, readonly) NSInteger naviRouteID;
|
||
|
||
///当前导航路径的信息,参考 AMapNaviRoute 类.
|
||
///The information of the current navigation path, refer to the AMapNaviRoute class
|
||
@property (nonatomic, readonly, nullable) AMapNaviRoute *naviRoute;
|
||
|
||
/**
|
||
* @brief 多路径规划时的所有路径信息 since 7.5.0
|
||
* All path information during multi-path planning
|
||
* @return 返回多路径规划时的所有路径ID和路线信息
|
||
* Returns all path IDs and route information during multi-path planning
|
||
*/
|
||
- (NSDictionary<NSNumber *,AMapNaviRoute *> *)naviRoutes;
|
||
|
||
|
||
/**
|
||
* @brief 多路径规划时的所有路径ID,路径ID为 NSInteger 类型 since 7.5.0
|
||
* All path IDs during multi-path planning, where path IDs are of type NSInteger
|
||
* @return 返回多路径规划时的所有路径ID
|
||
* Returns all path IDs during multi-path planning
|
||
*/
|
||
- (NSArray<NSNumber *> *)naviRouteIDs;
|
||
|
||
/**
|
||
* @brief 多路径规划时选择路径.注意:该方法仅限于在开始导航前使用,开始导航后该方法无效 since 7.5.0
|
||
* Select route during multi-path planning.Note: This method can only be used before starting navigation and becomes invalid after navigation begins
|
||
* @param routeID 路径ID
|
||
* Route ID
|
||
* @return 是否选择路径成功
|
||
* Whether route selection is successful
|
||
*/
|
||
- (BOOL)selectNaviRouteWithRouteID:(NSInteger)routeID;
|
||
|
||
#pragma mark - Options
|
||
|
||
///偏航时是否重新计算路径,默认YES(需要联网).
|
||
///Whether to recalculate route when deviating, default is YES (requires internet connection).
|
||
@property (nonatomic, assign) BOOL isRecalculateRouteForYaw __attribute__((deprecated("Deprecated, recalculated by default, since 7.4.0")));
|
||
|
||
///卫星定位信号强度类型,参考 AMapNaviGPSSignalStrength since 7.8.0 只有导航中获取卫星定位信号强弱的值有效
|
||
///Satellite positioning signal strength type, refer to AMapNaviGPSSignalStrength, since 7.8.0 only the value obtained during navigation is valid
|
||
@property (nonatomic, assign, readonly) AMapNaviGPSSignalStrength gpsSignalStrength;
|
||
|
||
#pragma mark - Calculate Route
|
||
|
||
// 以下算路方法需要高德坐标(GCJ02)
|
||
// The following routing methods require Amap coordinates(GCJ02)
|
||
|
||
/**
|
||
* @brief 不带起点的骑行路径规划
|
||
* Bike route planning without starting point
|
||
* @param endPoint 终点坐标.
|
||
* Destination coordinates
|
||
* @return 规划路径所需条件和参数校验是否成功，不代表算路成功与否
|
||
* Whether the conditions and parameters required for route planning are successfully verified does not indicate whether the route calculation is successful
|
||
*/
|
||
- (BOOL)calculateRideRouteWithEndPoint:(AMapNaviPoint *)endPoint;
|
||
|
||
/**
|
||
* @brief 带起点的骑行路径规划
|
||
* Bike route planning with starting point
|
||
* @param startPoint 起点坐标.
|
||
* Starting point coordinates
|
||
* @param endPoint 终点坐标.
|
||
* Destination coordinates
|
||
* @return 规划路径所需条件和参数校验是否成功，不代表算路成功与否
|
||
* Whether the conditions and parameters required for route planning are successfully verified does not indicate whether the route calculation is successful
|
||
*/
|
||
- (BOOL)calculateRideRouteWithStartPoint:(AMapNaviPoint *)startPoint
|
||
endPoint:(AMapNaviPoint *)endPoint;
|
||
|
||
/**
|
||
* @brief 根据高德POIInfo进行骑行路径规划. since 7.5.0
|
||
* Plan the cycling route based on Amap POIInfo
|
||
* @param startPOIInfo 起点POIInfo, 参考 AMapNaviPOIInfo. 如果以“我的位置”作为起点,请传nil. 如果startPOIInfo不为nil,那么POIID合法,优先使用ID参与算路,否则使用坐标点
|
||
* Starting point POIInfo, refer to AMapNaviPOIInfo. If 'My Location' is used as the starting point, please pass nil. If startPOIInfo is not nil, then the POIID is valid, and the ID is used for route calculation first; otherwise, the coordinate point is used
|
||
* @param endPOIInfo 终点POIInfo, 参考 AMapNaviPOIInfo. 如果POIID合法,优先使用ID参与算路,否则使用坐标点. 注意:POIID和坐标点不能同时为空
|
||
* Destination POIInfo, refer to AMapNaviPOIInfo. If the POIID is valid, prioritize using the ID for route calculation; otherwise, use the coordinate point. Note: POIID and coordinate point cannot be empty simultaneously.
|
||
* @param strategy 路径的计算策略，参考 AMapNaviTravelStrategy.
|
||
* Route calculation strategy, refer to AMapNaviTravelStrategy
|
||
* @return 规划路径所需条件和参数校验是否成功，不代表算路成功与否
|
||
* Whether the conditions and parameters required for route planning are successfully verified does not indicate whether the route calculation is successful
|
||
*/
|
||
- (BOOL)calculateRideRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
|
||
endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
|
||
strategy:(AMapNaviTravelStrategy)strategy;
|
||
|
||
/**
|
||
* @brief POI算路。 since 9.3.5
|
||
* POI routing
|
||
* @param startPOIInfo 起点POIInfo，如果以“我的位置”作为起点，请传nil。如果startPOIInfo不为nil，那么POIID合法，优先使用ID参与算路，否则使用坐标点。
|
||
* Starting point POIInfo, If 'My Location' is used as the starting point, please pass nil. If startPOIInfo is not nil, then the POIID is valid, and the ID is used for route calculation first; otherwise, the coordinate point is used
|
||
* @param endPOIInfo 终点POIInfo，如果POIID合法，优先使用ID参与算路，否则使用坐标点。注意：POIID和坐标点不能同时为空。
|
||
* Destination POIInfo, If the POIID is valid, prioritize using the ID for route calculation; otherwise, use the coordinate point. Note: POIID and coordinate point cannot be empty simultaneously.
|
||
* @param wayPOIInfos 途经点POIInfo，最多支持16个途经点，超过16个会取前16个。如果POIID合法，优先使用ID参与算路，否则使用坐标点。 注意：POIID和坐标点不能同时为空。
|
||
* Waypoint POIInfo, supports up to 16 waypoints, exceeding 16 will take the first 16. If the POIID is valid, prioritize using the ID for route calculation; otherwise, use the coordinate point. Note: POIID and coordinate point cannot be empty simultaneously.
|
||
* @param strategy 路径的计算策略。
|
||
* Route calculation strategy
|
||
* @return 规划路径所需条件和参数校验是否成功，不代表算路成功与否。
|
||
* Whether the conditions and parameters required for route planning are successfully verified does not indicate whether the route calculation is successful
|
||
*/
|
||
- (BOOL)calculateRideRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
|
||
endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
|
||
wayPOIInfos:(NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
|
||
strategy:(AMapNaviTravelStrategy)strategy;
|
||
|
||
/**
|
||
* @brief POI算路。 since 10.1.111
|
||
* POI routing
|
||
* @param startPOIInfo 起点POIInfo，如果以“我的位置”作为起点，请传nil。如果startPOIInfo不为nil，那么POIID合法，优先使用ID参与算路，否则使用坐标点。
|
||
* Starting point POIInfo, If 'My Location' is used as the starting point, please pass nil. If startPOIInfo is not nil, then the POIID is valid, and the ID is used for route calculation first; otherwise, the coordinate point is used
|
||
* @param endPOIInfo 终点POIInfo，如果POIID合法，优先使用ID参与算路，否则使用坐标点。注意：POIID和坐标点不能同时为空。
|
||
* Destination POIInfo, If the POIID is valid, prioritize using the ID for route calculation; otherwise, use the coordinate point. Note: POIID and coordinate point cannot be empty simultaneously.
|
||
* @param wayPOIInfos 途经点POIInfo，最多支持16个途经点，超过16个会取前16个。如果POIID合法，优先使用ID参与算路，否则使用坐标点。 注意：POIID和坐标点不能同时为空。
|
||
* Waypoint POIInfo, supports up to 16 waypoints, exceeding 16 will take the first 16. If the POIID is valid, prioritize using the ID for route calculation; otherwise, use the coordinate point. Note: POIID and coordinate point cannot be empty simultaneously.
|
||
* @param strategy 路径的计算策略。
|
||
* Route calculation strategy
|
||
* @param callback 算路结果回调。一次算路，routeResult 中的 routeRequestId 与 算路成功、算路失败接口中返回的 routeRequestId 一致。
|
||
* Route calculation result callback. For a single route calculation, the routeRequestId in the routeResult is consistent with the routeRequestId returned by the route success and route failure interfaces.
|
||
* @return 规划路径所需条件和参数校验是否成功，不代表算路成功与否。
|
||
* Whether the conditions and parameters required for route planning are successfully verified does not indicate whether the route calculation is successful
|
||
*/
|
||
- (BOOL)calculateRideRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
|
||
endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
|
||
wayPOIInfos:(NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
|
||
strategy:(AMapNaviTravelStrategy)strategy
|
||
callback:(nullable void (^)(AMapNaviCalculateRouteResult *_Nullable routeResult))callback;
|
||
|
||
/**
|
||
* @brief 独立算路能力接口，可用于不干扰本次导航的单独算路场景. since 7.7.0
|
||
* Independent routing capability interface, which can be used for standalone routing scenarios without interfering with the current navigation
|
||
* @param startPOIInfo 起点POIInfo, 参考 AMapNaviPOIInfo. 如果以“我的位置”作为起点,请传nil. 如果startPOIInfo不为nil,那么POIID合法,优先使用ID参与算路,否则使用坐标点
|
||
* Starting point POIInfo, refer to AMapNaviPOIInfo. If 'My Location' is used as the starting point, please pass nil. If startPOIInfo is not nil, then the POIID is valid, and the ID is used for route calculation first; otherwise, the coordinate point is used
|
||
* @param endPOIInfo 终点POIInfo, 参考 AMapNaviPOIInfo. 如果POIID合法,优先使用ID参与算路,否则使用坐标点. 注意:POIID和坐标点不能同时为空
|
||
* Destination POIInfo, refer to AMapNaviPOIInfo. If the POIID is valid, prioritize using the ID for route calculation; otherwise, use the coordinate point. Note: POIID and coordinate point cannot be empty simultaneously.
|
||
* @param strategy 路径的计算策略，参考 AMapNaviTravelStrategy.
|
||
* Route calculation strategy, refer to AMapNaviTravelStrategy
|
||
* @param callback 算路完成的回调. 算路成功时，routeGroup 不为空；算路失败时，error 不为空，error.code参照 AMapNaviCalcRouteState.
|
||
* Callback for route calculation completion. When the route calculation is successful, routeGroup is not empty; when it fails, error is not empty, and error.code refers to AMapNaviCalcRouteState.
|
||
* @return 规划路径所需条件和参数校验是否成功，不代表算路成功与否
|
||
* Whether the conditions and parameters required for route planning are successfully verified does not indicate whether the route calculation is successful
|
||
*/
|
||
- (BOOL)independentCalculateRideRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
|
||
endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
|
||
strategy:(AMapNaviTravelStrategy)strategy
|
||
callback:(nullable void (^)(AMapNaviRouteGroup *_Nullable routeGroup, NSError *_Nullable error))callback;
|
||
|
||
/**
|
||
* @brief 独立算路能力接口，可用于不干扰本次导航的单独算路场景。特别注意：当前接口为收费接口，您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通 https://lbs.amap.com/。since 9.3.5
|
||
* Independent route calculation capability API, which can be used in standalone route calculation scenarios without interfering with the current navigation. Special note: This is a paid API. If you wish to apply for a trial or formal use, please submit a business cooperation ticket via the ticket system for communication https://lbs.amap.com/
|
||
* @param startPOIInfo 起点POIInfo，如果以“我的位置”作为起点，请传nil。如果startPOIInfo不为nil，那么POIID合法，优先使用ID参与算路，否则使用坐标点。
|
||
* Starting point POIInfo, If 'My Location' is used as the starting point, please pass nil. If startPOIInfo is not nil, then the POIID is valid, and the ID is used for route calculation first; otherwise, the coordinate point is used
|
||
* @param endPOIInfo 终点POIInfo，如果POIID合法，优先使用ID参与算路，否则使用坐标点。注意：POIID和坐标点不能同时为空。
|
||
* Destination POIInfo, If the POIID is valid, prioritize using the ID for route calculation; otherwise, use the coordinate point. Note: POIID and coordinate point cannot be empty simultaneously.
|
||
* @param wayPOIInfos 途经点POIInfo，最多支持16个途经点，超过16个会取前16个。如果POIID合法，优先使用ID参与算路，否则使用坐标点。注意：POIID和坐标点不能同时为空。
|
||
* Waypoint POIInfo, supports up to 16 waypoints, exceeding 16 will take the first 16. If the POIID is valid, prioritize using the ID for route calculation; otherwise, use the coordinate point. Note: POIID and coordinate point cannot be empty simultaneously.
|
||
* @param strategy 路径的计算策略。
|
||
* Route calculation strategy
|
||
* @param callback 算路完成的回调。算路成功时，routeGroup 不为空，算路失败时，error 不为空，error.code参照 AMapNaviCalcRouteState。
|
||
* Callback for route calculation completion. When the route calculation is successful, routeGroup is not empty; when it fails, error is not empty, and error.code refers to AMapNaviCalcRouteState.
|
||
* @return 规划路径所需条件和参数校验是否成功，不代表算路成功与否。
|
||
* Whether the conditions and parameters required for route planning are successfully verified does not indicate whether the route calculation is successful
|
||
*/
|
||
- (BOOL)independentCalculateRideRouteWithStartPOIInfo:(nullable AMapNaviPOIInfo *)startPOIInfo
|
||
endPOIInfo:(nonnull AMapNaviPOIInfo *)endPOIInfo
|
||
wayPOIInfos:(NSArray<AMapNaviPOIInfo *> *)wayPOIInfos
|
||
strategy:(AMapNaviTravelStrategy)strategy
|
||
callback:(nullable void (^)(AMapNaviRouteGroup *_Nullable routeGroup, NSError *_Nullable error))callback;
|
||
|
||
/**
|
||
* @brief 导航过程中重新规划路径(起点为当前位置,终点位置不变)
|
||
* Re-planning the route during navigation (starting from the current location with the destination unchanged)
|
||
* @return 重新规划路径所需条件和参数校验是否成功， 不代表算路成功与否，如非导航状态下调用此方法会返回NO.
|
||
* The success of the conditions and parameter validation required for re-planning the route does not indicate whether the route calculation is successful. Calling this method outside of navigation will return NO.
|
||
*/
|
||
- (BOOL)recalculateRideRoute;
|
||
|
||
/**
|
||
* @brief 导航过程中重新规划路径(起点为当前位置,终点位置不变)。since 10.1.111
|
||
* Re-planning the route during navigation (starting from the current location with the destination unchanged)
|
||
* @param callback 算路结果回调。一次算路，routeResult 中的 routeRequestId 与 算路成功、算路失败接口中返回的 routeRequestId 一致
|
||
* Route calculation result callback. For a single route calculation, the routeRequestId in the routeResult is consistent with the routeRequestId returned by the route success and route failure interfaces.
|
||
* @return 重新规划路径所需条件和参数校验是否成功， 不代表算路成功与否，如非导航状态下调用此方法会返回NO.
|
||
* The success of the conditions and parameter validation required for re-planning the route does not indicate whether the route calculation is successful. Calling this method outside of navigation will return NO.
|
||
*/
|
||
- (BOOL)recalculateRideRouteWithCallback:(nullable void (^)(AMapNaviCalculateRouteResult *_Nullable routeResult))callback;
|
||
|
||
#pragma mark - Manual
|
||
|
||
/**
|
||
* @brief 设置TTS语音播报每播报一个字需要的时间.根据播报一个字的时间和运行的速度,可以更改语音播报的触发时机.
|
||
* Set the time required for TTS voice broadcast to broadcast each word. Based on the time to broadcast a word and the speed of operation, the trigger timing of the voice broadcast can be changed.
|
||
* @param time 每个字的播放时间(范围:[250,500]; 单位:毫秒)
|
||
* The playback time of each character (range: [250,500]; unit: milliseconds)
|
||
*/
|
||
- (void)setTimeForOneWord:(int)time __attribute__((deprecated("Deprecated, use setIsPlayingTTS: instead, since 7.4.0")));
|
||
|
||
/**
|
||
* @brief 开发者请根据实际情况设置外界此时是否正在进行语音播报. since 7.4.0
|
||
* Developers, please set whether external voice broadcast is currently ongoing based on the actual situation
|
||
* @param playing 如果外界正在播报语音，传入YES，否则传入NO.
|
||
* If external voice broadcast is ongoing, pass YES, otherwise pass NO
|
||
*/
|
||
- (void)setTTSPlaying:(BOOL)playing;
|
||
|
||
#pragma mark - Statistics Information
|
||
|
||
/**
|
||
* @brief 获取导航统计信息
|
||
* Obtain navigation statistics
|
||
* @return 导航统计信息,参考 AMapNaviStatisticsInfo 类.
|
||
* Navigation statistics information, refer to AMapNaviStatisticsInfo class
|
||
*/
|
||
- (nullable AMapNaviStatisticsInfo *)getNaviStatisticsInfo __attribute__((deprecated("Deprecated, since 7.4.0")));
|
||
|
||
@end
|
||
|
||
#pragma mark - AMapNaviRideManagerDelegate
|
||
|
||
@protocol AMapNaviRideManagerDelegate <NSObject>
|
||
@optional
|
||
|
||
/**
|
||
* @brief 发生错误时,会调用代理的此方法
|
||
* When an error occurs, this method of the delegate will be called
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
* @param error 错误信息
|
||
* Error message
|
||
*/
|
||
- (void)rideManager:(AMapNaviRideManager *)rideManager error:(NSError *)error;
|
||
|
||
/**
|
||
* @brief 骑行路径规划成功后的回调函数
|
||
* Callback function after successful cycling route planning
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
*/
|
||
- (void)rideManagerOnCalculateRouteSuccess:(AMapNaviRideManager *)rideManager;
|
||
|
||
/**
|
||
* @brief 骑行路径规划成功后的回调函数。since 10.1.111
|
||
* Callback function after successful cycling route planning
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
* @param calculateRouteResult 算路结果，算路唯一标识在此对象中。
|
||
* The route calculation result, the unique identifier of the route calculation is in this object
|
||
*/
|
||
- (void)rideManagerOnCalculateRouteSuccess:(AMapNaviRideManager *)rideManager calculateRouteResult:(AMapNaviCalculateRouteResult *)calculateRouteResult;
|
||
|
||
/**
|
||
* @brief 骑行路径规划失败后的回调函数. 从6.1.0版本起,算路失败后导航SDK只对外通知算路失败,SDK内部不再执行停止导航的相关逻辑.因此,当算路失败后,不会收到 driveManager:updateNaviMode: 回调; AMapNaviRideManager.naviMode 不会切换到 AMapNaviModeNone 状态, 而是会保持在 AMapNaviModeGPS or AMapNaviModeEmulator 状态
|
||
* Callback function after failed cycling route planning. Starting from version 6.1.0, the navigation SDK only notifies external parties of route calculation failure, and the SDK no longer executes the logic related to stopping navigation internally. Therefore, after the route calculation fails, the driveManager:updateNaviMode: callback will not be received. AMapNaviRideManager.naviMode will not switch to AMapNaviModeNone state, but will remain in AMapNaviModeGPS or AMapNaviModeEmulator state.
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
* @param error 错误信息,error.code参照AMapNaviCalcRouteState
|
||
* Error message, error.code refers to AMapNaviCalcRouteState.
|
||
*/
|
||
- (void)rideManager:(AMapNaviRideManager *)rideManager onCalculateRouteFailure:(NSError *)error;
|
||
|
||
/**
|
||
* @brief 骑行路径规划失败后的回调函数. 从6.1.0版本起,算路失败后导航SDK只对外通知算路失败,SDK内部不再执行停止导航的相关逻辑.因此,当算路失败后,不会收到 driveManager:updateNaviMode: 回调; AMapNaviRideManager.naviMode 不会切换到 AMapNaviModeNone 状态, 而是会保持在 AMapNaviModeGPS or AMapNaviModeEmulator 状态。since 10.1.111
|
||
* Callback function after failed cycling route planning. Starting from version 6.1.0, the navigation SDK only notifies external parties of route calculation failure, and the SDK no longer executes the logic related to stopping navigation internally. Therefore, after the route calculation fails, the driveManager:updateNaviMode: callback will not be received. AMapNaviRideManager.naviMode will not switch to AMapNaviModeNone state, but will remain in AMapNaviModeGPS or AMapNaviModeEmulator state.
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
* @param error 错误信息,error.code参照AMapNaviCalcRouteState
|
||
* Error message, error.code refers to AMapNaviCalcRouteState.
|
||
* @param calculateRouteResult 算路结果，算路唯一标识在此对象中。
|
||
* Routing result, the unique routing identifier is in this object
|
||
*/
|
||
- (void)rideManager:(AMapNaviRideManager *)rideManager onCalculateRouteFailure:(NSError *)error calculateRouteResult:(AMapNaviCalculateRouteResult *)calculateRouteResult;
|
||
|
||
/**
|
||
* @brief 启动导航后回调函数
|
||
* Callback function after starting navigation
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
* @param naviMode 导航类型，参考AMapNaviMode
|
||
* Navigation type, refer to AMapNaviMode
|
||
*/
|
||
- (void)rideManager:(AMapNaviRideManager *)rideManager didStartNavi:(AMapNaviMode)naviMode;
|
||
|
||
/**
|
||
* @brief 停止导航后回调函数. since 10.1.300
|
||
* @param rideManager 骑行导航管理类
|
||
* @param isStopped 是否停止导航成功
|
||
*/
|
||
- (void)rideManager:(AMapNaviRideManager *)rideManager didStopNavi:(BOOL)isStopped;
|
||
|
||
/**
|
||
* @brief 出现偏航需要重新计算路径时的回调函数.偏航后将自动重新路径规划,该方法将在自动重新路径规划前通知您进行额外的处理.
|
||
* The callback function when a deviation occurs and the path needs to be recalculated. After the deviation, the path will be automatically replanned, and this method will notify you to perform additional processing before the automatic replanning.
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
*/
|
||
- (void)rideManagerNeedRecalculateRouteForYaw:(AMapNaviRideManager *)rideManager;
|
||
|
||
/**
|
||
* @brief 导航播报信息回调函数
|
||
* Navigation broadcast information callback function
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
* @param soundString 播报文字
|
||
* Broadcast text
|
||
* @param soundStringType 播报类型,参考 AMapNaviSoundType. 注意：since 6.0.0 AMapNaviSoundType 只返回 AMapNaviSoundTypeDefault
|
||
* Broadcast type, refer to AMapNaviSoundType. Note: since 6.0.0 AMapNaviSoundType only returns AMapNaviSoundTypeDefault
|
||
*/
|
||
- (void)rideManager:(AMapNaviRideManager *)rideManager playNaviSoundString:(NSString *)soundString soundStringType:(AMapNaviSoundType)soundStringType;
|
||
|
||
/**
|
||
* @brief 模拟导航到达目的地停止导航后的回调函数
|
||
* Callback function after simulated navigation reaches the destination and stops navigation
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
*/
|
||
- (void)rideManagerDidEndEmulatorNavi:(AMapNaviRideManager *)rideManager;
|
||
|
||
/**
|
||
* @brief 导航到达目的地后的回调函数
|
||
* Callback function after navigation reaches the destination
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
*/
|
||
- (void)rideManagerOnArrivedDestination:(AMapNaviRideManager *)rideManager;
|
||
|
||
/**
|
||
* @brief 卫星定位信号强弱回调函数. since 7.4.0
|
||
* Callback function for satellite positioning signal strength
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
* @param gpsSignalStrength 卫星定位信号强度类型,参考 AMapNaviGPSSignalStrength .
|
||
* Satellite positioning signal strength type, refer to AMapNaviGPSSignalStrength.
|
||
*/
|
||
- (void)rideManager:(AMapNaviRideManager *)rideManager updateGPSSignalStrength:(AMapNaviGPSSignalStrength)gpsSignalStrength;
|
||
|
||
/**
|
||
* @brief 骑行导航到达途径点的回调函数 since 9.3.5
|
||
* Callback function when reaching a waypoint in cycling navigation
|
||
* @param rideManager 骑行导航管理类
|
||
* Cycling navigation management class
|
||
* @param wayPointIndex 到达途径点的编号，编号从0开始，依次累加。
|
||
* The index of the waypoint, starting from 0 and incrementing sequentially
|
||
*/
|
||
- (void)rideManager:(AMapNaviRideManager *)rideManager onArrivedWayPoint:(int)wayPointIndex;
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|