TencentNavigationKit
TNKCarNaviView Class Reference

驾车导航UI类. More...

#import <TNKCarNaviView.h>

Inheritance diagram for TNKCarNaviView:
TNKBaseNaviView <TNKCarNaviUIDelegate>

Instance Methods

(CGPoint TNKCarNaviFixCarProportion3D) - __attribute__
 3D导航时自车点位置在地图上位置的比例 默认值为(0.5,0.75). x取值范围为[0.25,0.75] 表示从屏幕左边起的宽度比例. y取值范围为[0.25,0.75] 表示从屏幕上边起的高度比例. 若设置值不在区间内则使用默认值. More...
 
(CGPoint TNKCarNaviFixCarProportion2D) - __attribute__
 2D导航时自车点位置在地图上位置的比例 默认值为(0.5,0.75). x取值范围为[0.25,0.75] 表示从屏幕左边起的宽度比例. y取值范围为[0.25,0.75] 表示从屏幕上边起的高度比例. 若设置值不在区间内则使用默认值. More...
 
(NSDictionary< NSNumber *, UIColor * > *routeColorDictionary) - __attribute__
 驾车导航过程中路况线的颜色. 需在导航开始前设置.since 5.2.3.1 More...
 
(NSDictionary< NSNumber *, UIColor * > *accompanyRouteColorDictionary) - __attribute__
 驾车导航过程中伴随路线的颜色. 需在导航开始前设置.value对应的是自定义的颜色配置.since 5.2.3.1 More...
 
(void) - setElectronicEyeEnabled:
 设置显示/隐藏电子眼标识.该方法用于导航状态下控制显示/隐藏导航路线上的电子眼标识. 非导航过程中调用该方法无效. 电子眼标识在3D车头朝上和2D地图朝北模式下会默认显示, 在全览模式和剩余全览模式下会隐藏. More...
 
(void) - setTrafficBubbleEnabled:
 设置显示/隐藏路况气泡.该方法用于导航状态下控制显示/隐藏导航路线上的路况气泡. 默认隐藏;当打开之后, 路况气泡在3D车头朝上和2D地图朝北模式下会显示, 在全览模式和剩余全览模式下会隐藏. since 5.2.5 More...
 
(void) - setCarCompassEnabled:
 设置显示/隐藏自车点罗盘.该方法用于导航状态下控制显示/隐藏自车点罗盘. 非导航过程中调用该方法无效. 自车点罗盘在3D车头朝上模式下会默认显示, 在2D地图朝北、全览模式和剩余全览模式下会默认隐藏. More...
 
(void) - setShowVectorLineEnabled:
 设置牵引线开关,默认不显示. since 5.2.5 More...
 
(void) - hideEnlargedIntersetion
 移除本次展示的路口放大图. since 5.2.7 More...
 
- Instance Methods inherited from TNKBaseNaviView
(void) - clearAllRouteUI
 清除路线相关UI.该方法用于非导航状态下清除路线相关UI,包括导航路线、自车点图标、动态添加的限速/指示标识等. 导航过程中调用该方法无效. More...
 
(void) - configUserLocationPresentation:
 配置自车位置UI属性. 该方法用于配置导航时自车位置UI属性, 非导航时进行配置会在导航发起后生效, 导航过程中进行配置即时生效. More...
 
(void) - configStartPointMarkerPresentation:
 配置起点UI属性. 该方法用于配置导航时起点UI属性, 非导航时进行配置会在导航发起后生效. More...
 
(void) - configWayPointMarkerPresentation:
 配置途径点点UI属性. 该方法用于配置导航时途径点UI属性, 非导航时进行配置会在导航发起后生效. More...
 
(void) - configEndPointMarkerPresentation:
 配置终点UI属性. 该方法用于配置导航时终点UI属性, 非导航时进行配置会在导航发起后生效. More...
 
(void) - setMapStyle:
 改变底图样式。注意,如果调用该方法,日夜间模式样式将不再发生变化. since 5.2.4.4 More...
 
(void) - setTurnArrowEnabled:
 设置显示/隐藏转弯箭头指引.该方法用于导航状态下控制显示/隐藏下一个转弯箭头指引. 非导航过程中调用该方法无效. 转弯箭头指引在3D车头朝上和2D地图朝北模式下会默认显示, 在全览模式和剩余全览模式下会默认隐藏. More...
 
(void) - setCompassEnabled:
 设置显示/隐藏自车点罗盘.该方法用于导航状态下控制显示/隐藏自车点罗盘. 非导航过程中调用该方法无效. 自车点罗盘在3D车头朝上模式下会默认显示, 在2D地图朝北、全览模式和剩余全览模式下会默认隐藏. More...
 
(instancetype) - initWithFrame:config:
 初始化 TNKCarNaviView. since 5.2.4.4 More...
 
(void) - removeAllOverlays
 移除导航元素以外的overlays. More...
 
(void) - removeAllAnnotations
 移除导航元素以外的annotations. More...
 
- Instance Methods inherited from <TNKCarNaviUIDelegate>
(void) - carNavigationManager:updateNavigationData:
 导航数据回调. More...
 
(void) - carNavigationManager:showEnlargedIntersectionImage:
 显示路口放大图回调. More...
 
(void) - carNavigationManagerHideEnlargedIntersectionImage:
 隐藏路口放大图回调. More...
 
(void) - carNavigationManager:showGuidedLaneImage:
 显示车道线回调. More...
 
(void) - carNavigationManager:showGuidedLaneInfo:
 显示车道信息回调. since 5.3.3 More...
 
(void) - carNavigationManagerHideGuidedLaneImage:
 隐藏车道线回调. More...
 
(void) - carNavigationManager:updateRouteTrafficStatus:
 更新当前路线路况数据回调. 其中包括路线总距离、路线剩余距离及路况情况. More...
 
(void) - carNavigationManagerDidSmartLocStart:
 开启智能定位的回调. since 5.2.2 More...
 
(void) - carNavigationManagerDidSmartLocStop:
 关闭智能定位的回调. since 5.2.2 More...
 
(void) - carNavigationManager:routeDidChange:routeTrafficStatus:
 路线切换回调 More...
 
(void) - carNavigationManager:didDeleteBackupRoutes:
 开启多路线功能时,删除备选路线的回调. since 5.2.6 More...
 
(void) - carNavigationManager:didAddBackupRoutes:
 开启多路线功能时,补充了备选路线的回调. since 5.2.6 More...
 
(void) - carNavigationManager:updateBackupRoutesTrafficStatus:
 更新备选路线路况数据更新回调. 其中路线剩余距离及路况情况. since 5.2.6 More...
 

Properties

id< TNKCarNaviViewDelegatedelegate
 TNKCarNaviView的回调,用于接收导航模式、日夜状态等变化. More...
 
id< TNKCarNaviViewDataSourcedataSource
 TNKCarNaviView的数据源,用于获取所需的数据. More...
 
BOOL hideNavigationPanel
 是否隐藏顶部导航面板, 默认为NO. More...
 
BOOL enlargedIntersectionEnabled
 设置在3D车头朝上和2D地图朝北模式下 显示/隐藏路口放大图. 注意不管此参数如何设置,在全览模式和剩余全览模式下都会隐藏. More...
 
BOOL guidedLaneEnabled
 设置在3D车头朝上和2D地图朝北模式下 显示/隐藏路口车道线. 注意不管此参数如何设置,在全览模式和剩余全览模式下都会隐藏. More...
 
NSUInteger panelTopGap
 导航面板顶部空隙距离. 默认为全屏状态下避开状态栏. 取值范围为[0,100]. More...
 
UIEdgeInsets enlargedIntersectionEdgeInsets
 路口放大图摆放位置,top为顶部空隙距离,left为左间距,right为右间距 。路口放大图有固定比例,位置和大小由top、left、right决定,bottom无需设置。 当前正在展示路口放大图时,修改不会立即生效,下次展示路口放大图时生效 More...
 
BOOL showEnlargedIntersectionProgressView
 路口放大图中顶部的进度条是否展示,默认为YES. since 5.2.4.4 More...
 
BOOL showUIElements
 是否显示界面元素,默认NO。(不包含对导航面板的控制) More...
 
BOOL showTrafficBar
 是否显示路况光柱图,默认NO More...
 
BOOL showRoadTypeButton
 是否显示主辅路切换按钮,默认NO More...
 
BOOL showOverviewButton
 是否显示全览/退出全览切换按钮,默认NO More...
 
BOOL showBottomToolbar
 是否显示底部工具栏,默认NO(包含退出、剩余距离时间、预计到达时间、设置) More...
 
BOOL showCurrentSpeedView
 是否显示当前车速, 默认NO More...
 
BOOL showLimitSpeedAndCurrentRoadNameView
 是否显示限速、当前路名, 默认NO More...
 
BOOL showSmartLocView
 是否显示智能定位. 默认NO. since 5.2.2 More...
 
BOOL showMapTrafficButton
 是否显示切换实时路况的按钮,默认NO More...
 
BOOL showFeedbackButton
 是否显示问题上报按钮,默认NO. More...
 
BOOL showZoomLevelControl
 是否显示调整zoomlevel控件,默认NO More...
 
BOOL showToast
 是否显示提示(包括GPS变弱、恢复,切换路线成功,手动刷新路线),默认NO More...
 
BOOL showServiceAreaInfo
 是否显示高速休息区信息,默认NO More...
 
BOOL showRouteRefreshButton
 是否显示路线刷新按钮,默认为NO. since 5.2.5 More...
 
BOOL showRouteExplain
 是否显示路线解释性信息,默认为NO. since 5.3.9 More...
 
TNKCarNaviUIMode mode
 导航视角模式. 导航模式包括3D车头朝上、2D地图朝北、全览和剩余全览4种模式. 默认为3D车头朝上模式. 回弹模式在导航状态下使用手势操作地图时被触发,会在手势操作结束后一段时间切换回之前的导航模式. 该时间可由bounceTime设定,默认回弹时间为5秒.直接设置导航模式为回弹模式将不会被响应. More...
 
TNKCarNaviUIMode nonOverviewNaviUIMode
 非全览的导航视角模式. 导航模式包括3D车头朝上、2D地图朝. More...
 
TNKCarNaviUIMode overviewNaviUIMode
 全览的导航视角模式. 全览和剩余全览. More...
 
TNKCarNaviDayNightMode dayNightMode
 地图日夜间模式切换策略. 包括自动切换、始终白天、始终黑夜3种模式. 默认为日夜状态自动切换. More...
 
TNKCarNaviDayNightStatus dayNightStatus
 获取地图当前日夜状态. More...
 
QMapView * naviMapView
 内部持有的地图实例,可以通过该地图实例接收地图事件回调、添加annotation、操作地图视野等. More...
 
TNKCarRouteConfigrouteConfig
 驾车导航路线样式配置 More...
 
UIColor * vectorLineColor
 牵引线颜色. 默认为红色. since 5.2.4 More...
 
BOOL showTraffic
 设置导航地图是否显示实时路况,不影响showMapTrafficButton的逻辑 More...
 
BOOL autoScaleEnabled
 设置导航地图是否开启自动缩放比例尺功能,默认关闭。 开启之后,3D车头朝上、2D地图朝北模式会在路口处自动调整地图zoomlevel和overlooking,以提供最佳视野通过路口。since 5.2.5 More...
 
CGFloat autoScaleMinZoomLevel
 自动缩放比例尺功能中,可设置最小zoomlevel,默认15, 取值范围[14, 17] 。since 5.2.9.6 More...
 
TNKBackupRouteBubbleConfigbackupRouteBubbleConfig
 设置导航地图备选路线上的气泡的样式。since 5.2.8 More...
 
BOOL backupRoutesHidden
 是否隐藏备选路线,默认为NO。 设置为YES,备选路线依然存在,但不展示在地图上。 More...
 
CGFloat enlargedIntersectionAspect
 路口放大图宽高比,取值范围[1.0 , 2.0], 默认值为kTNKEnlargedIntersectionAspect。since 5.3.2 More...
 
- Properties inherited from TNKBaseNaviView
BOOL bounceEnabled
 是否允许navi view进行回弹; 默认为YES More...
 
NSUInteger bounceTime
 回弹模式的回弹时间,单位为秒,需大于0. 默认为5秒. More...
 
CGPoint fix3DProportion
 3D导航时自车点位置在地图上位置的比例 默认值为(0.5,0.75). x取值范围为[0.25,0.75] 表示从屏幕左边起的宽度比例. y取值范围为[0.25,0.75] 表示从屏幕上边起的高度比例. 若设置值不在区间内则使用默认值. More...
 
CGPoint fix2DProportion
 2D导航时自车点位置在地图上位置的比例 默认值为(0.5,0.75). x取值范围为[0.25,0.75] 表示从屏幕左边起的宽度比例. y取值范围为[0.25,0.75] 表示从屏幕上边起的高度比例. 若设置值不在区间内则使用默认值. More...
 
NSUInteger routeLineWidth
 设置地图绘制路线的线宽. 默认值为12 px. More...
 
NSUInteger routeLineEraseType
 设置导航时已走过路线的处理方式. 0为置灰,1为擦除. 默认为0. More...
 
CGFloat routeSymbolGap
 导航过程中路况线上的箭头密度.需在导航开始前设置. 默认值是100.since 5.2.3.1 More...
 
UIEdgeInsets externalEdgeInsets
 设置全览和剩余全览模式下导航路线显示区域距离地图四周的边距. 当在CarNaviView上自定义显示元素时, 为避免与导航路线相互遮挡, 可调用该接口调整导航路线显示区域范围. 默认值为(80,80,150,40), 使得全览和剩余全览模式下导航路线四周有部分留白. More...
 

Detailed Description

驾车导航UI类.

用于显示默认导航UI,包括导航面板,路线,车标,起终点等.

Method Documentation

◆ __attribute__ [1/4]

- (CGPoint TNKCarNaviFixCarProportion2D) __attribute__ ((deprecated("已废弃,使用TNKBaseNaviView的fix2DProportion,since 5.2.6"))) 

2D导航时自车点位置在地图上位置的比例 默认值为(0.5,0.75). x取值范围为[0.25,0.75] 表示从屏幕左边起的宽度比例. y取值范围为[0.25,0.75] 表示从屏幕上边起的高度比例. 若设置值不在区间内则使用默认值.

◆ __attribute__ [2/4]

- (CGPoint TNKCarNaviFixCarProportion3D) __attribute__ ((deprecated("已废弃,使用TNKBaseNaviView的fix3DProportion,since 5.2.6"))) 

3D导航时自车点位置在地图上位置的比例 默认值为(0.5,0.75). x取值范围为[0.25,0.75] 表示从屏幕左边起的宽度比例. y取值范围为[0.25,0.75] 表示从屏幕上边起的高度比例. 若设置值不在区间内则使用默认值.

◆ __attribute__ [3/4]

- (NSDictionary< NSNumber *, UIColor * > *routeColorDictionary) __attribute__ ((deprecated("已废弃,使用TNKCarNaviView的routeConfig,since 5.3.6"))) 

驾车导航过程中路况线的颜色. 需在导航开始前设置.since 5.2.3.1

Note
key可以取-1~4,对应TNKRouteTrafficDataStatus; value对应的是自定义的颜色配置.

◆ __attribute__ [4/4]

- (NSDictionary< NSNumber *, UIColor * > *accompanyRouteColorDictionary) __attribute__ ((deprecated("已废弃,使用TNKCarNaviView的routeConfig,since 5.3.6"))) 

驾车导航过程中伴随路线的颜色. 需在导航开始前设置.value对应的是自定义的颜色配置.since 5.2.3.1

Note
key可以取0~4,对应TNKRouteTrafficDataStatus; value对应的是自定义的颜色配置.

◆ hideEnlargedIntersetion

- (void) hideEnlargedIntersetion

移除本次展示的路口放大图. since 5.2.7

◆ setCarCompassEnabled:

- (void) setCarCompassEnabled: ((deprecated("已废弃,使用TNKBaseNaviView的setCompassEnabled,since 5.2.6")))  __attribute__

设置显示/隐藏自车点罗盘.该方法用于导航状态下控制显示/隐藏自车点罗盘. 非导航过程中调用该方法无效. 自车点罗盘在3D车头朝上模式下会默认显示, 在2D地图朝北、全览模式和剩余全览模式下会默认隐藏.

◆ setElectronicEyeEnabled:

- (void) setElectronicEyeEnabled: (BOOL)  enabled

设置显示/隐藏电子眼标识.该方法用于导航状态下控制显示/隐藏导航路线上的电子眼标识. 非导航过程中调用该方法无效. 电子眼标识在3D车头朝上和2D地图朝北模式下会默认显示, 在全览模式和剩余全览模式下会隐藏.

◆ setShowVectorLineEnabled:

- (void) setShowVectorLineEnabled: (BOOL)  enabled

设置牵引线开关,默认不显示. since 5.2.5

◆ setTrafficBubbleEnabled:

- (void) setTrafficBubbleEnabled: (BOOL)  enabled

设置显示/隐藏路况气泡.该方法用于导航状态下控制显示/隐藏导航路线上的路况气泡. 默认隐藏;当打开之后, 路况气泡在3D车头朝上和2D地图朝北模式下会显示, 在全览模式和剩余全览模式下会隐藏. since 5.2.5

Property Documentation

◆ autoScaleEnabled

- (BOOL) autoScaleEnabled
readwritenonatomicassign

设置导航地图是否开启自动缩放比例尺功能,默认关闭。 开启之后,3D车头朝上、2D地图朝北模式会在路口处自动调整地图zoomlevel和overlooking,以提供最佳视野通过路口。since 5.2.5

◆ autoScaleMinZoomLevel

- (CGFloat) autoScaleMinZoomLevel
readwritenonatomicassign

自动缩放比例尺功能中,可设置最小zoomlevel,默认15, 取值范围[14, 17] 。since 5.2.9.6

◆ backupRouteBubbleConfig

- (TNKBackupRouteBubbleConfig*) backupRouteBubbleConfig
readwritenonatomicstrong

设置导航地图备选路线上的气泡的样式。since 5.2.8

◆ backupRoutesHidden

- (BOOL) backupRoutesHidden
readwritenonatomicassign

是否隐藏备选路线,默认为NO。 设置为YES,备选路线依然存在,但不展示在地图上。

◆ dataSource

- (id<TNKCarNaviViewDataSource>) dataSource
readwritenonatomicweak

TNKCarNaviView的数据源,用于获取所需的数据.

◆ dayNightMode

- (TNKCarNaviDayNightMode) dayNightMode
readwritenonatomicassign

地图日夜间模式切换策略. 包括自动切换、始终白天、始终黑夜3种模式. 默认为日夜状态自动切换.

◆ dayNightStatus

- (TNKCarNaviDayNightStatus) dayNightStatus
readnonatomicassign

获取地图当前日夜状态.

◆ delegate

- (id<TNKCarNaviViewDelegate>) delegate
readwritenonatomicweak

TNKCarNaviView的回调,用于接收导航模式、日夜状态等变化.

◆ enlargedIntersectionAspect

- (CGFloat) enlargedIntersectionAspect
readwritenonatomicassign

路口放大图宽高比,取值范围[1.0 , 2.0], 默认值为kTNKEnlargedIntersectionAspect。since 5.3.2

◆ enlargedIntersectionEdgeInsets

- (UIEdgeInsets) enlargedIntersectionEdgeInsets
readwritenonatomicassign

路口放大图摆放位置,top为顶部空隙距离,left为左间距,right为右间距 。路口放大图有固定比例,位置和大小由top、left、right决定,bottom无需设置。 当前正在展示路口放大图时,修改不会立即生效,下次展示路口放大图时生效

◆ enlargedIntersectionEnabled

- (BOOL) enlargedIntersectionEnabled
readwritenonatomicassign

设置在3D车头朝上和2D地图朝北模式下 显示/隐藏路口放大图. 注意不管此参数如何设置,在全览模式和剩余全览模式下都会隐藏.

◆ guidedLaneEnabled

- (BOOL) guidedLaneEnabled
readwritenonatomicassign

设置在3D车头朝上和2D地图朝北模式下 显示/隐藏路口车道线. 注意不管此参数如何设置,在全览模式和剩余全览模式下都会隐藏.

◆ hideNavigationPanel

- (BOOL) hideNavigationPanel
readwritenonatomicassign

是否隐藏顶部导航面板, 默认为NO.

◆ mode

- (TNKCarNaviUIMode) mode
readwritenonatomicassign

导航视角模式. 导航模式包括3D车头朝上、2D地图朝北、全览和剩余全览4种模式. 默认为3D车头朝上模式. 回弹模式在导航状态下使用手势操作地图时被触发,会在手势操作结束后一段时间切换回之前的导航模式. 该时间可由bounceTime设定,默认回弹时间为5秒.直接设置导航模式为回弹模式将不会被响应.

◆ naviMapView

- (QMapView*) naviMapView
readnonatomicstrong

内部持有的地图实例,可以通过该地图实例接收地图事件回调、添加annotation、操作地图视野等.

◆ nonOverviewNaviUIMode

- (TNKCarNaviUIMode) nonOverviewNaviUIMode
readwritenonatomicassign

非全览的导航视角模式. 导航模式包括3D车头朝上、2D地图朝.

◆ overviewNaviUIMode

- (TNKCarNaviUIMode) overviewNaviUIMode
readwritenonatomicassign

全览的导航视角模式. 全览和剩余全览.

◆ panelTopGap

- (NSUInteger) panelTopGap
readwritenonatomicassign

导航面板顶部空隙距离. 默认为全屏状态下避开状态栏. 取值范围为[0,100].

◆ routeConfig

- (TNKCarRouteConfig*) routeConfig
readwritenonatomicstrong

驾车导航路线样式配置

Note
TNKCarRouteColorPalette 中的eraseColor 不支持动态更新.

◆ showBottomToolbar

- (BOOL) showBottomToolbar
readwritenonatomicassign

是否显示底部工具栏,默认NO(包含退出、剩余距离时间、预计到达时间、设置)

◆ showCurrentSpeedView

- (BOOL) showCurrentSpeedView
readwritenonatomicassign

是否显示当前车速, 默认NO

◆ showEnlargedIntersectionProgressView

- (BOOL) showEnlargedIntersectionProgressView
readwritenonatomicassign

路口放大图中顶部的进度条是否展示,默认为YES. since 5.2.4.4

◆ showFeedbackButton

- (BOOL) showFeedbackButton
readwritenonatomicassign

是否显示问题上报按钮,默认NO.

◆ showLimitSpeedAndCurrentRoadNameView

- (BOOL) showLimitSpeedAndCurrentRoadNameView
readwritenonatomicassign

是否显示限速、当前路名, 默认NO

◆ showMapTrafficButton

- (BOOL) showMapTrafficButton
readwritenonatomicassign

是否显示切换实时路况的按钮,默认NO

◆ showOverviewButton

- (BOOL) showOverviewButton
readwritenonatomicassign

是否显示全览/退出全览切换按钮,默认NO

◆ showRoadTypeButton

- (BOOL) showRoadTypeButton
readwritenonatomicassign

是否显示主辅路切换按钮,默认NO

◆ showRouteExplain

- (BOOL) showRouteExplain
readwritenonatomicassign

是否显示路线解释性信息,默认为NO. since 5.3.9

◆ showRouteRefreshButton

- (BOOL) showRouteRefreshButton
readwritenonatomicassign

是否显示路线刷新按钮,默认为NO. since 5.2.5

◆ showServiceAreaInfo

- (BOOL) showServiceAreaInfo
readwritenonatomicassign

是否显示高速休息区信息,默认NO

◆ showSmartLocView

- (BOOL) showSmartLocView
readwritenonatomicassign

是否显示智能定位. 默认NO. since 5.2.2

◆ showToast

- (BOOL) showToast
readwritenonatomicassign

是否显示提示(包括GPS变弱、恢复,切换路线成功,手动刷新路线),默认NO

◆ showTraffic

- (BOOL) showTraffic
readwritenonatomicassign

设置导航地图是否显示实时路况,不影响showMapTrafficButton的逻辑

◆ showTrafficBar

- (BOOL) showTrafficBar
readwritenonatomicassign

是否显示路况光柱图,默认NO

◆ showUIElements

- (BOOL) showUIElements
readwritenonatomicassign

是否显示界面元素,默认NO。(不包含对导航面板的控制)

◆ showZoomLevelControl

- (BOOL) showZoomLevelControl
readwritenonatomicassign

是否显示调整zoomlevel控件,默认NO

◆ vectorLineColor

- (UIColor*) vectorLineColor
readwritenonatomicstrong

牵引线颜色. 默认为红色. since 5.2.4


The documentation for this class was generated from the following file: