TencentNavKit
TNKTravelNavView.h
Go to the documentation of this file.
1//
2// TNKTravelNavView.h
3// TencentNavKit
4//
5// Created by xzg on 2025/7/16.
6// Copyright © 2025 Tencent. All rights reserved.
7//
8
9#import <TencentNavKit/TNKBaseNavView.h>
10#import <TencentNavKit/TNKDriveNavDelegate.h>
11#import <TencentNavKit/TNKDriveNavViewDelegate.h>
12#import <TencentNavKit/TNKWaypointMarkerPresentation.h>
13#import <TencentNavKit/TNKNaviTrafficBarWidget.h>
14#import <TencentNavKit/TNKEnlargedMapConfig.h>
15#import <TencentNavKit/TNKUIComponentConfig.h>
16#import "TNKCustomAreaView.h"
17
18
19
20NS_ASSUME_NONNULL_BEGIN
21
24
28@property (nonatomic, weak, nullable) id<TNKDriveNavViewDelegate> delegate;
29
30
31//**************** 导航界面元素控制-开始 ****************//
32
36@property (nonatomic, assign) NSUInteger panelTopGap;
37
41@property (nonatomic, assign) NSUInteger panelButtomGap;
42
46- (TNKTravelNavView *(^)(NSUInteger))withPanelTopGap;
47
51- (TNKTravelNavView *(^)(NSUInteger))withPanelButtomGap;
52
56@property (nonatomic, assign) BOOL navigationPanelEnabled;
57
62
67@property (nonatomic, assign) BOOL guidedLaneEnabled;
68
72@property (nonatomic, assign) BOOL showRecommendRoute;
73
78
82@property (nonatomic, assign) BOOL showUIElements;
83
88
92//@property (nonatomic, assign) BOOL showBottomToolbar;
93
98
102@property (nonatomic, assign) BOOL showToast;
103
107- (TNKTravelNavView *(^)(BOOL))withShowToast;
108
112@property (nonatomic, assign) BOOL showCurrentSpeedView;
113
118
122@property (nonatomic, assign) BOOL showGrossSpeedingView;
123
128
132@property (nonatomic, assign) BOOL showTrafficBar;
133
138
142@property (nonatomic, readonly, nullable) TNKNaviTrafficBarWidget *trafficBar;
143
147@property (nonatomic, assign) BOOL showRoadTypeButton;
148
153
157@property (nonatomic, assign) BOOL showSettingButton;
158
163
164
168@property (nonatomic, assign) BOOL showExitButton;
169
174
178@property (nonatomic, assign) BOOL showLimitSpeedAndCurrentRoadNameView;
179
184
188@property (nonatomic, assign) BOOL showSmartLocView;
189
194
198@property (nonatomic, assign) BOOL showOverviewButton;
199
204
208@property (nonatomic, assign) BOOL showRouteRefreshButton;
209
214
218@property (nonatomic, assign) BOOL showMapTrafficButton;
219
224
228@property (nonatomic, assign) BOOL showBroadCastButton;
229
234
238@property (nonatomic, assign) BOOL showServiceAreaInfo;
239
244
248- (void)setAllComponentVisibility:(BOOL)visible;
249
254- (TNKTravelNavView *(^)(void))build;
255
259- (void)setUIComponentConfig:(TNKUIComponentConfig *)uiComponentConfig;
260
265
266//**************** 导航界面元素控制-结束 ****************//
267
268
274@property (nonatomic, getter=isAutoScaleEnabled) BOOL autoScaleEnabled;
275
280@property (nonatomic, assign) CGFloat autoScaleMinZoomLevel;
281
285@property (nonatomic, assign) BOOL showTraffic;
286
290@property (nonatomic, assign) BOOL shows3DBuildings;
291
296@property (nonatomic, assign) BOOL routeTrafficLightHidden;
297
302@property (nonatomic, assign) BOOL lightCountDownTimerHidden;
303
307@property (nonatomic, assign) BOOL backupRouteBubbleHidden;
308
313@property (nonatomic, assign) BOOL cameraMarkerEnabled;
314
319@property (nonatomic, assign) BOOL showDistanceOnCamera;
320
321
325@property (nonatomic, assign) BOOL showRouteExplain;
326
331
337@property (nonatomic, assign) BOOL trafficBubbleEnabled;
338
343@property (nonatomic, readonly) TNKTravelEnlargedMapConfig *enlargedMapConfig;
344
345
349@property (nonatomic, strong, readonly) TNKCustomAreaView *customAreaView;
350
351
352
356- (void)setCustomAreaHeight:(CGFloat)height;
357
358
364- (void)updateEnlargedMapConfig:(TNKTravelEnlargedMapConfig *)enlargedMapConfig;
365
371
379- (void)updateWaypointMarkerPresentation:(NSDictionary<NSString *, TNKWaypointMarkerPresentation *> * _Nullable)waypointMarkerPresentationDictionary;
380
387- (void)setBackupRoutesHidden:(BOOL)hidden backupRouteIDs:(NSArray<NSString *> * _Nullable)backupRouteIDs;
388
392- (void)createExitNaviAlert;
393
394@end
395
396NS_ASSUME_NONNULL_END
导航地图基础类
Definition: TNKBaseNavView.h:26
Definition: TNKCustomAreaView.h:26
路况光柱图
Definition: TNKNaviTrafficBarWidget.h:29
Definition: TNKEnlargedMapConfig.h:65
驾车导航地图类
Definition: TNKTravelNavView.h:23
BOOL withShowRouteExplain()
是否显示路线解释性信息,链式开关,默认NO since 7.3.0
void createExitNaviAlert()
创建退出导航弹框。
BOOL withShowSettingButton()
是否显示设置按钮,链式调用,默认NO
BOOL showCurrentSpeedView
是否显示当前车速, 默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:112
void removeCurrentEnlargedMap()
移除本次展示的路口放大图.
BOOL showTrafficBar
是否显示路况光柱图,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:132
BOOL showToast
是否显示提示(包括GPS变弱、恢复,切换路线成功,手动刷新路线),默认NO
Definition: TNKTravelNavView.h:102
TNKCustomAreaView * customAreaView
Definition: TNKTravelNavView.h:349
BOOL withShowMapTrafficButton()
是否显示切换实时路况的按钮,默认NO. since 7.0.0
BOOL showExitButton
是否显示退出按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:168
BOOL lightCountDownTimerHidden
是否隐藏路线上的红绿灯倒计时,默认为NO。
Definition: TNKTravelNavView.h:302
BOOL withShowServiceAreaInfo()
是否显示高速休息区信息,默认NO since 7.0.0
BOOL showTraffic
设置导航地图是否显示实时路况,不影响showMapTrafficButton的逻辑,默认为YES。
Definition: TNKTravelNavView.h:285
NSUInteger panelButtomGap
导航面板底部空隙距离. 预留给业务使用的区域. 默认值0, 取值范围[0,.
Definition: TNKTravelNavView.h:41
BOOL withShowGrossSpeedingView()
设置是否展示严重超速视图,默认NO. since 7.0.0
BOOL cameraMarkerEnabled
设置是否展示路线上的电子眼.默认值为YES。 电子眼标识在3D车头朝上和2D地图朝北模式下会默认显示, 在全览模式和剩余全览模式下会隐藏.
Definition: TNKTravelNavView.h:313
BOOL showRouteExplain
是否显示路线解释性信息,默认NO since 7.3.0
Definition: TNKTravelNavView.h:325
BOOL showLimitSpeedAndCurrentRoadNameView
是否显示限速、当前路名, 默认NO
Definition: TNKTravelNavView.h:178
BOOL showRouteRefreshButton
是否显示路线刷新按钮,默认为NO,需在开启导航后设置. since 5.2.5
Definition: TNKTravelNavView.h:208
TNKUIComponentConfig * getUIComponentConfig()
BOOL autoScaleEnabled
设置导航地图是否开启自动缩放比例尺功能,默认开启。 开启之后,3D车头朝上、2D地图朝北模式会在路口处自动调整地图zoomlevel和overlooking,以提供最佳视野通过路口。
Definition: TNKTravelNavView.h:274
id< TNKDriveNavViewDelegate > delegate
TNKDriveNavView的回调,用于接收导航模式、日夜状态等变化.
Definition: TNKTravelNavView.h:28
BOOL withShowToast()
设置是否显示提示(包括GPS变弱、恢复,切换路线成功,手动刷新路线),默认NO. since 7.0.0
BOOL showBroadCastButton
是否显示语音播报按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:228
NSUInteger withPanelTopGap()
设置导航面板顶部空隙距离. 默认为全屏状态下避开状态栏. 取值范围为[0,100]. since 7.0.0
void build()
builder模式构建方法 since 7.0.0
BOOL withShowOverviewButton()
设置是否显示全览/退出全览切换按钮,默认NO. since 7.0.0
BOOL showServiceAreaInfo
是否显示高速休息区信息,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:238
BOOL withShowCurrentSpeedView()
设置是否显示当前车速, 默认NO. since 7.0.0
BOOL withGuidedLaneEnabled()
设置显示/隐藏路口车道线. 默认为YES since 7.0.0
NSUInteger withPanelButtomGap()
导航面板底部空隙距离. 预留给业务使用的区域. 取值范围[0,. since 7.2.0
BOOL showRoadTypeButton
是否显示主辅路切换按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:147
BOOL withShowExitButton()
是否显示退出按钮,链式调用,默认NO
BOOL withShowSmartLocView()
设置是否显示智能定位. 默认NO. since 7.0.0
BOOL showRecommendRoute
是否展示推荐换路弹窗, 默认为YES
Definition: TNKTravelNavView.h:72
BOOL withShowRoadTypeButton()
设置是否显示主辅路切换按钮,默认NO. since 7.0.0
BOOL showMapTrafficButton
是否显示切换实时路况的按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:218
BOOL guidedLaneEnabled
设置在3D车头朝上和2D地图朝北模式下 显示/隐藏路口车道线. 默认为YES 注意不管此参数如何设置,在全览模式和剩余全览模式下都会隐藏.
Definition: TNKTravelNavView.h:67
BOOL backupRouteBubbleHidden
设置隐藏备选路线上的气泡,默认为NO;
Definition: TNKTravelNavView.h:307
BOOL showGrossSpeedingView
是否展示严重超速视图,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:122
BOOL showDistanceOnCamera
电子眼上是否展示剩余距离。默认为NO
Definition: TNKTravelNavView.h:319
BOOL routeTrafficLightHidden
是否隐藏路线上的红绿灯,默认为NO。
Definition: TNKTravelNavView.h:296
CGFloat autoScaleMinZoomLevel
自动缩放比例尺功能中,可设置最小zoomlevel,默认15, 取值范围[14, 17] 。
Definition: TNKTravelNavView.h:280
BOOL withShowBottomToolbar()
是否显示底部工具栏,默认NO(包含退出、剩余距离时间、预计到达时间、设置)
BOOL withNavigationPanelEnabled()
设置是否展示顶部导航面板, 默认为YES since 7.0.0
BOOL trafficBubbleEnabled
设置显示/隐藏路况气泡.该方法用于导航状态下控制显示/隐藏导航路线上的路况气泡. 默认为YES 路况气泡在3D车头朝上和2D地图朝北模式下会显示, 在全览模式和剩余全览模式下会隐藏.
Definition: TNKTravelNavView.h:337
BOOL showOverviewButton
是否显示全览/退出全览切换按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:198
NSUInteger panelTopGap
导航面板顶部空隙距离. 默认为全屏状态下避开状态栏. 取值范围为[0,100].
Definition: TNKTravelNavView.h:36
BOOL withShowRouteRefreshButton()
设置是否显示路线刷新按钮,默认为NO. since 7.0.0
BOOL withShowBroadCastButton()
是否显示语音播报按钮,默认NO since 7.0.0
BOOL showSettingButton
是否显示设置按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:157
TNKNaviTrafficBarWidget * trafficBar
光柱图实例,当showTrafficBar为YES时才不为空
Definition: TNKTravelNavView.h:142
BOOL withShowTrafficBar()
设置是否显示路况光柱图,默认NO. since 7.0.0
BOOL withShowUIElements()
设置是否显示界面元素,默认NO。(不包含对导航面板的控制)since 7.0.0
BOOL shows3DBuildings
是否显示建筑物样式为3D效果,默认为NO。
Definition: TNKTravelNavView.h:290
BOOL withShowLimitSpeedAndCurrentRoadNameView()
设置是否显示限速、当前路名, 默认NO. since 7.0.0
BOOL showUIElements
是否显示界面元素,默认NO。(不包含对导航面板的控制),需在开启导航后设置
Definition: TNKTravelNavView.h:82
BOOL navigationPanelEnabled
是否展示顶部导航面板, 默认为YES
Definition: TNKTravelNavView.h:56
TNKTravelEnlargedMapConfig * enlargedMapConfig
放大图相关配置
Definition: TNKTravelNavView.h:343
BOOL showSmartLocView
是否显示智能定位. 默认NO. since 5.2.2
Definition: TNKTravelNavView.h:188
Definition: TNKUIComponentConfig.h:7
途经点配置类
Definition: TNKWaypointMarkerPresentation.h:16
驾车导航事件回调
Definition: TNKDriveNavDelegate.h:34