|
高德地图SDK(导航) V10.0.900
|
步行导航管理类 More...
#import <AMapNaviWalkManager.h>
Instance Methods | |
| (instancetype) | - init |
| 请使用单例替代. since 7.4.0 init已被禁止使用,请使用单例 [AMapNaviWalkManager sharedInstance] 替代 | |
| (void) | - addEventListener: |
| 增加用于接收导航回调事件的Listener, 效果等同于delegate. 注意:该方法不会增加实例对象的引用计数(Weak Reference). since 8.0.1 | |
| (void) | - removeEventListener: |
| 移除用于接收导航回调事件的Listener. since 8.0.1 | |
| (void) | - addDataRepresentative: |
| 增加用于展示导航数据的DataRepresentative.注意:该方法不会增加实例对象的引用计数(Weak Reference) | |
| (void) | - removeDataRepresentative: |
| 移除用于展示导航数据的DataRepresentative | |
| (NSDictionary< NSNumber *, AMapNaviRoute * > *) | - naviRoutes |
| 多路径规划时的所有路径信息 since 7.5.0 | |
| (NSArray< NSNumber * > *) | - naviRouteIDs |
| 多路径规划时的所有路径ID,路径ID为 NSInteger 类型 since 7.5.0 | |
| (BOOL) | - selectNaviRouteWithRouteID: |
| 多路径规划时选择路径.注意:该方法仅限于在开始导航前使用,开始导航后该方法无效 since 7.5.0 | |
| (BOOL) | - calculateWalkRouteWithEndPoints: |
| 不带起点的步行路径规划 | |
| (BOOL) | - calculateWalkRouteWithStartPoints:endPoints: |
| 带起点的步行路径规划 | |
| (BOOL) | - calculateWalkRouteWithStartPOIInfo:endPOIInfo:strategy: |
| 根据高德POIInfo进行步行路径规划. since 7.5.0 | |
| (BOOL) | - calculateWalkRouteWithStartPOIInfo:endPOIInfo:wayPOIInfos:strategy: |
| POI算路。特别注意:当前接口为收费接口,您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通 https://lbs.amap.com/。 since 9.3.5. | |
| (BOOL) | - independentCalculateWalkRouteWithStartPOIInfo:endPOIInfo:strategy:callback: |
| 独立算路能力接口,可用于不干扰本次导航的单独算路场景. since 7.8.0 | |
| (BOOL) | - independentCalculateWalkRouteWithStartPOIInfo:endPOIInfo:wayPOIInfos:strategy:callback: |
| 独立算路能力接口,可用于不干扰本次导航的单独算路场景。特别注意:当前接口为收费接口,您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通 https://lbs.amap.com/。 since 9.4.0 | |
| (BOOL) | - recalculateWalkRoute |
| 导航过程中重新规划路径(起点为当前位置,终点位置不变) | |
| (void) | - setTimeForOneWord: |
| 设置TTS语音播报每播报一个字需要的时间.根据播报一个字的时间和运行的速度,可以更改语音播报的触发时机. | |
| (void) | - setTTSPlaying: |
| 开发者请根据实际情况设置外界此时是否正在进行语音播报. since 7.4.0 | |
| (nullable AMapNaviStatisticsInfo *) | - getNaviStatisticsInfo |
| 获取导航统计信息 | |
Instance Methods inherited from AMapNaviBaseManager | |
| (void) | - setExternalLocation:isAMapCoordinate: |
| 设置外部传入定位的信息 | |
| (void) | - setEmulatorNaviSpeed: |
| 设置模拟导航的速度,默认60 | |
| (BOOL) | - startEmulatorNavi |
| 开始模拟导航. 注意:必须在路径规划成功的情况下,才能够开始模拟导航 | |
| (BOOL) | - startGPSNavi |
| 开始实时导航. 注意:必须在路径规划成功的情况下,才能够开始实时导航 | |
| (BOOL) | - startEmulatorNavi: |
| 开始模拟导航. 注意:必须传入导航的路线组合routeGroup,才能够开始模拟导航. since 7.7.0 | |
| (BOOL) | - startGPSNavi: |
| 开始实时导航. 注意:必须传入导航的路线组合routeGroup,才能够开始实时导航. since 7.7.0 | |
| (void) | - stopNavi |
| 停止导航,包含实时导航和模拟导航 | |
| (void) | - pauseNavi |
| 暂停导航,包含实时导航和模拟导航 | |
| (void) | - resumeNavi |
| 继续导航,包含实时导航和模拟导航 | |
| (BOOL) | - readNaviInfoManual |
| 实时导航中手动触发一次信息播报. 注意:该接口仅支持驾车和步行,骑行不支持此功能. | |
| (nullable NSArray< AMapNaviGuide * > *) | - getNaviGuideList |
| 获取导航路线的路线详情列表 | |
Class Methods | |
| (AMapNaviWalkManager *) | + sharedInstance |
| AMapNaviWalkManager单例. since 7.4.0. | |
| (BOOL) | + destroyInstance |
| 销毁AMapNaviWalkManager单例. since 7.4.0 | |
Properties | |
| id< AMapNaviWalkManagerDelegate > | delegate |
| 实现了 AMapNaviWalkManagerDelegate 协议的类指针 | |
| NSInteger | naviRouteID |
| 当前导航路径的ID | |
| AMapNaviRoute * | naviRoute |
| 当前导航路径的信息,参考 AMapNaviRoute 类. | |
| BOOL | isRecalculateRouteForYaw |
| 偏航时是否重新计算路径,默认YES(需要联网). | |
| AMapNaviGPSSignalStrength | gpsSignalStrength |
| 卫星定位信号强度类型,参考 AMapNaviGPSSignalStrength since 7.8.0 只有导航中获取卫星定位信号强弱的值有效 | |
Properties inherited from AMapNaviBaseManager | |
| AMapNaviMode | naviMode |
| 当前导航模式,参考 AMapNaviMode . | |
| BOOL | screenAlwaysBright |
| 是否在导航过程中让屏幕常亮,默认YES. | |
| BOOL | pausesLocationUpdatesAutomatically |
| 指定定位是否会被系统自动暂停。默认为YES。 | |
| BOOL | allowsBackgroundLocationUpdates |
| 是否允许后台定位.默认为NO(只在iOS 9.0及以后版本起作用).注意:设置为YES的时候必须保证 Background Modes 中的 Location updates 处于选中状态,否则会抛出异常. | |
| BOOL | enableExternalLocation |
| 是否采用外部传入定位信息.注意:默认NO. | |
| CLLocation * | externalLocation |
| 外部传入定位信息(enableExternalLocation为YES时有效).该方法坐标需使用WGS84坐标系. | |
| BOOL | isUseInternalTTS |
| 是否使用内置播放器进行导航播报, 如果为YES,就是由导航SDK来播报导航信息. 默认为NO. since 5.5.0 | |
步行导航管理类
| - (void) addDataRepresentative: | (id< AMapNaviWalkDataRepresentable >) | aRepresentative |
增加用于展示导航数据的DataRepresentative.注意:该方法不会增加实例对象的引用计数(Weak Reference)
| aRepresentative | 实现了 AMapNaviWalkDataRepresentable 协议的实例 |
| - (void) addEventListener: | (id< AMapNaviWalkManagerDelegate >) | aListener |
增加用于接收导航回调事件的Listener, 效果等同于delegate. 注意:该方法不会增加实例对象的引用计数(Weak Reference). since 8.0.1
| aListener | 实现了 AMapNaviRideManagerDelegate 协议的实例 |
| - (BOOL) calculateWalkRouteWithEndPoints: | (NSArray< AMapNaviPoint * > *) | endPoints |
不带起点的步行路径规划
| endPoints | 终点坐标.支持多个终点,终点列表的尾点为实时导航终点,其他坐标点为辅助信息,带有方向性,可有效避免算路到马路的另一侧. |
| - (BOOL) calculateWalkRouteWithStartPOIInfo: | (nullable AMapNaviPOIInfo *) | startPOIInfo | |
| endPOIInfo: | (nonnull AMapNaviPOIInfo *) | endPOIInfo | |
| strategy: | (AMapNaviTravelStrategy) | strategy | |
根据高德POIInfo进行步行路径规划. since 7.5.0
| startPOIInfo | 起点POIInfo, 参考 AMapNaviPOIInfo. 如果以“我的位置”作为起点,请传nil. 如果startPOIInfo不为nil,那么POIID合法,优先使用ID参与算路,否则使用坐标点 |
| endPOIInfo | 终点POIInfo, 参考 AMapNaviPOIInfo. 如果POIID合法,优先使用ID参与算路,否则使用坐标点. 注意:POIID和坐标点不能同时为空 |
| strategy | 路径的计算策略,参考 AMapNaviTravelStrategy. |
| - (BOOL) calculateWalkRouteWithStartPOIInfo: | (nullable AMapNaviPOIInfo *) | startPOIInfo | |
| endPOIInfo: | (nonnull AMapNaviPOIInfo *) | endPOIInfo | |
| wayPOIInfos: | (nullable NSArray< AMapNaviPOIInfo * > *) | wayPOIInfos | |
| strategy: | (AMapNaviTravelStrategy) | strategy | |
POI算路。特别注意:当前接口为收费接口,您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通 https://lbs.amap.com/。 since 9.3.5.
| startPOIInfo | 起点POIInfo,如果以“我的位置”作为起点,请传nil。如果startPOIInfo不为nil,那么POIID合法,优先使用ID参与算路,否则使用坐标点。 |
| endPOIInfo | 终点POIInfo,如果POIID合法,优先使用ID参与算路,否则使用坐标点。注意:POIID和坐标点不能同时为空。 |
| wayPOIInfos | 途经点POIInfo,最多支持16个途经点,超过16个会取前16个。如果POIID合法,优先使用ID参与算路,否则使用坐标点。注意:POIID和坐标点不能同时为空。 |
| strategy | 路径的计算策略。 |
| - (BOOL) calculateWalkRouteWithStartPoints: | (NSArray< AMapNaviPoint * > *) | startPoints | |
| endPoints: | (NSArray< AMapNaviPoint * > *) | endPoints | |
带起点的步行路径规划
| startPoints | 起点坐标.支持多个起点,起点列表的尾点为实时导航起点,其他坐标点为辅助信息,带有方向性,可有效避免算路到马路的另一侧. |
| endPoints | 终点坐标.支持多个终点,终点列表的尾点为实时导航终点,其他坐标点为辅助信息,带有方向性,可有效避免算路到马路的另一侧. |
| + (BOOL) destroyInstance |
销毁AMapNaviWalkManager单例. since 7.4.0
| - (nullable AMapNaviStatisticsInfo *) getNaviStatisticsInfo |
获取导航统计信息
| - (BOOL) independentCalculateWalkRouteWithStartPOIInfo: | (nullable AMapNaviPOIInfo *) | startPOIInfo | |
| endPOIInfo: | (nonnull AMapNaviPOIInfo *) | endPOIInfo | |
| strategy: | (AMapNaviTravelStrategy) | strategy | |
| callback: | (nullable void(^)(AMapNaviRouteGroup *_Nullable routeGroup, NSError *_Nullable error)) | callback | |
独立算路能力接口,可用于不干扰本次导航的单独算路场景. since 7.8.0
| startPOIInfo | 起点POIInfo, 参考 AMapNaviPOIInfo. 如果以“我的位置”作为起点,请传nil. 如果startPOIInfo不为nil,那么POIID合法,优先使用ID参与算路,否则使用坐标点 |
| endPOIInfo | 终点POIInfo, 参考 AMapNaviPOIInfo. 如果POIID合法,优先使用ID参与算路,否则使用坐标点. 注意:POIID和坐标点不能同时为空 |
| strategy | 路径的计算策略,参考 AMapNaviTravelStrategy. |
| callback | 算路完成的回调. 算路成功时,routeGroup 不为空;算路失败时,error 不为空,error.code参照 AMapNaviCalcRouteState. |
| - (BOOL) independentCalculateWalkRouteWithStartPOIInfo: | (nullable AMapNaviPOIInfo *) | startPOIInfo | |
| endPOIInfo: | (nonnull AMapNaviPOIInfo *) | endPOIInfo | |
| wayPOIInfos: | (nullable NSArray< AMapNaviPOIInfo * > *) | wayPOIInfos | |
| strategy: | (AMapNaviTravelStrategy) | strategy | |
| callback: | (nullable void(^)(AMapNaviRouteGroup *_Nullable routeGroup, NSError *_Nullable error)) | callback | |
独立算路能力接口,可用于不干扰本次导航的单独算路场景。特别注意:当前接口为收费接口,您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通 https://lbs.amap.com/。 since 9.4.0
| startPOIInfo | 起点POIInfo,如果以“我的位置”作为起点,请传nil。如果startPOIInfo不为nil,那么POIID合法,优先使用ID参与算路,否则使用坐标点。 |
| endPOIInfo | 终点POIInfo,如果POIID合法,优先使用ID参与算路,否则使用坐标点。注意:POIID和坐标点不能同时为空。 |
| wayPOIInfos | 途经点POIInfo,最多支持16个途经点,超过16个会取前16个。如果POIID合法,优先使用ID参与算路,否则使用坐标点。注意:POIID和坐标点不能同时为空。 |
| strategy | 路径的计算策略。 |
| callback | 算路完成的回调。算路成功时,routeGroup 不为空;算路失败时,error 不为空,error.code参照 AMapNaviCalcRouteState。 |
| - (instancetype) init |
请使用单例替代. since 7.4.0 init已被禁止使用,请使用单例 [AMapNaviWalkManager sharedInstance] 替代
| - (NSArray< NSNumber * > *) naviRouteIDs |
多路径规划时的所有路径ID,路径ID为 NSInteger 类型 since 7.5.0
| - (NSDictionary< NSNumber *, AMapNaviRoute * > *) naviRoutes |
多路径规划时的所有路径信息 since 7.5.0
| - (BOOL) recalculateWalkRoute |
导航过程中重新规划路径(起点为当前位置,终点位置不变)
| - (void) removeDataRepresentative: | (id< AMapNaviWalkDataRepresentable >) | aRepresentative |
移除用于展示导航数据的DataRepresentative
| aRepresentative | 实现了 AMapNaviWalkDataRepresentable 协议的实例 |
| - (void) removeEventListener: | (id< AMapNaviWalkManagerDelegate >) | aListener |
移除用于接收导航回调事件的Listener. since 8.0.1
| aListener | 实现了 AMapNaviRideManagerDelegate 协议的实例 |
| - (BOOL) selectNaviRouteWithRouteID: | (NSInteger) | routeID |
多路径规划时选择路径.注意:该方法仅限于在开始导航前使用,开始导航后该方法无效 since 7.5.0
| routeID | 路径ID |
| - (void) setTimeForOneWord: | (int) | time |
设置TTS语音播报每播报一个字需要的时间.根据播报一个字的时间和运行的速度,可以更改语音播报的触发时机.
| time | 每个字的播放时间(范围:[250,500]; 单位:毫秒) |
| - (void) setTTSPlaying: | (BOOL) | playing |
开发者请根据实际情况设置外界此时是否正在进行语音播报. since 7.4.0
| playing | 如果外界正在播报语音,传入YES,否则传入NO. |
| + (AMapNaviWalkManager *) sharedInstance |
AMapNaviWalkManager单例. since 7.4.0.
|
readwritenonatomicweak |
实现了 AMapNaviWalkManagerDelegate 协议的类指针
|
readnonatomicassign |
卫星定位信号强度类型,参考 AMapNaviGPSSignalStrength since 7.8.0 只有导航中获取卫星定位信号强弱的值有效
|
readwritenonatomicassign |
偏航时是否重新计算路径,默认YES(需要联网).
|
readnonatomicassign |
当前导航路径的信息,参考 AMapNaviRoute 类.
|
readnonatomicassign |
当前导航路径的ID