TencentNavKit
TNKTravelNavView.h
Go to the documentation of this file.
1//
2// TNKTravelNavView.hpp
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/TNKTravelNavDelegate.h>
12#import <TencentNavKit/TNKDriveNavViewDelegate.h>
13#import <TencentNavKit/TNKWaypointMarkerPresentation.h>
14#import <TencentNavKit/TNKNaviTrafficBarWidget.h>
15#import <TencentNavKit/TNKEnlargedMapConfig.h>
16#import <TencentNavKit/TNKUIComponentConfig.h>
17#import "TNKCustomAreaView.h"
18
19NS_ASSUME_NONNULL_BEGIN
20
22//@interface TNKTravelNavView : TNKBaseNavView<TNKTravelNavDelegate>
24
28//@property (nonatomic, weak, nullable) id<TNKTravelNavViewDelegate> delegate;
29@property (nonatomic, weak, nullable) id<TNKDriveNavViewDelegate> delegate;
30
31
32//**************** 导航界面元素控制-开始 ****************//
33
37@property (nonatomic, assign) NSUInteger panelTopGap;
38
42@property (nonatomic, assign) NSUInteger panelButtomGap;
43
47- (TNKTravelNavView *(^)(NSUInteger))withPanelTopGap;
48
52- (TNKTravelNavView *(^)(NSUInteger))withPanelButtomGap;
53
57@property (nonatomic, assign) BOOL navigationPanelEnabled;
58
63
68@property (nonatomic, assign) BOOL guidedLaneEnabled;
69
74
78@property (nonatomic, assign) BOOL showUIElements;
79
84
88//@property (nonatomic, assign) BOOL showBottomToolbar;
89
94
98@property (nonatomic, assign) BOOL showToast;
99
103- (TNKTravelNavView *(^)(BOOL))withShowToast;
104
108@property (nonatomic, assign) BOOL showCurrentSpeedView;
109
114
118@property (nonatomic, assign) BOOL showGrossSpeedingView;
119
124
128@property (nonatomic, assign) BOOL showTrafficBar;
129
134
138@property (nonatomic, readonly, nullable) TNKNaviTrafficBarWidget *trafficBar;
139
143@property (nonatomic, assign) BOOL showRoadTypeButton;
144
149
153@property (nonatomic, assign) BOOL showSettingButton;
154
159
160
164@property (nonatomic, assign) BOOL showExitButton;
165
170
174@property (nonatomic, assign) BOOL showLimitSpeedAndCurrentRoadNameView;
175
180
184@property (nonatomic, assign) BOOL showSmartLocView;
185
190
194@property (nonatomic, assign) BOOL showOverviewButton;
195
200
204@property (nonatomic, assign) BOOL showRouteRefreshButton;
205
210
214@property (nonatomic, assign) BOOL showMapTrafficButton;
215
220
224@property (nonatomic, assign) BOOL showBroadCastButton;
225
230
234@property (nonatomic, assign) BOOL showServiceAreaInfo;
235
240
244- (void)setAllComponentVisibility:(BOOL)visible;
245
250- (TNKTravelNavView *(^)(void))build;
251
255- (void)setUIComponentConfig:(TNKUIComponentConfig *)uiComponentConfig;
256
261
262//**************** 导航界面元素控制-结束 ****************//
263
264
270@property (nonatomic, getter=isAutoScaleEnabled) BOOL autoScaleEnabled;
271
276@property (nonatomic, assign) CGFloat autoScaleMinZoomLevel;
277
281@property (nonatomic, assign) BOOL showTraffic;
282
286@property (nonatomic, assign) BOOL shows3DBuildings;
287
292@property (nonatomic, assign) BOOL routeTrafficLightHidden;
293
298@property (nonatomic, assign) BOOL lightCountDownTimerHidden;
299
303@property (nonatomic, assign) BOOL backupRouteBubbleHidden;
304
309@property (nonatomic, assign) BOOL cameraMarkerEnabled;
310
315@property (nonatomic, assign) BOOL showDistanceOnCamera;
316
322@property (nonatomic, assign) BOOL trafficBubbleEnabled;
323
328@property (nonatomic, readonly) TNKTravelEnlargedMapConfig *enlargedMapConfig;
329
330
334@property (nonatomic, strong, readonly) TNKCustomAreaView *customAreaView;
335
339- (void)setCustomAreaHeight:(CGFloat)height;
340
341
347- (void)updateEnlargedMapConfig:(TNKTravelEnlargedMapConfig *)enlargedMapConfig;
348
354
362- (void)updateWaypointMarkerPresentation:(NSDictionary<NSString *, TNKWaypointMarkerPresentation *> * _Nullable)waypointMarkerPresentationDictionary;
363
370- (void)setBackupRoutesHidden:(BOOL)hidden backupRouteIDs:(NSArray<NSString *> * _Nullable)backupRouteIDs;
371
372
373- (void)createExitNaviAlert;
374
375- (void)removeCustomView;
376
377@end
378
379NS_ASSUME_NONNULL_END
导航地图基础类
Definition: TNKBaseNavView.h:26
Definition: TNKCustomAreaView.h:26
路况光柱图
Definition: TNKNaviTrafficBarWidget.h:29
Definition: TNKEnlargedMapConfig.h:65
驾车导航地图类
Definition: TNKTravelNavView.h:23
void createExitNaviAlert()
BOOL withShowSettingButton()
是否显示设置按钮,链式调用,默认NO
BOOL showCurrentSpeedView
是否显示当前车速, 默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:108
void removeCurrentEnlargedMap()
移除本次展示的路口放大图.
BOOL showTrafficBar
是否显示路况光柱图,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:128
BOOL showToast
是否显示提示(包括GPS变弱、恢复,切换路线成功,手动刷新路线),默认NO
Definition: TNKTravelNavView.h:98
TNKCustomAreaView * customAreaView
Definition: TNKTravelNavView.h:334
BOOL withShowMapTrafficButton()
是否显示切换实时路况的按钮,默认NO. since 7.0.0
BOOL showExitButton
是否显示退出按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:164
BOOL lightCountDownTimerHidden
是否隐藏路线上的红绿灯倒计时,默认为NO。
Definition: TNKTravelNavView.h:298
BOOL withShowServiceAreaInfo()
是否显示高速休息区信息,默认NO since 7.0.0
BOOL showTraffic
设置导航地图是否显示实时路况,不影响showMapTrafficButton的逻辑,默认为YES。
Definition: TNKTravelNavView.h:281
NSUInteger panelButtomGap
导航面板底部空隙距离. 预留给业务使用的区域. 默认值0, 取值范围[0,.
Definition: TNKTravelNavView.h:42
BOOL withShowGrossSpeedingView()
设置是否展示严重超速视图,默认NO. since 7.0.0
BOOL cameraMarkerEnabled
设置是否展示路线上的电子眼.默认值为YES。 电子眼标识在3D车头朝上和2D地图朝北模式下会默认显示, 在全览模式和剩余全览模式下会隐藏.
Definition: TNKTravelNavView.h:309
BOOL showLimitSpeedAndCurrentRoadNameView
是否显示限速、当前路名, 默认NO
Definition: TNKTravelNavView.h:174
BOOL showRouteRefreshButton
是否显示路线刷新按钮,默认为NO,需在开启导航后设置. since 5.2.5
Definition: TNKTravelNavView.h:204
TNKUIComponentConfig * getUIComponentConfig()
BOOL autoScaleEnabled
设置导航地图是否开启自动缩放比例尺功能,默认开启。 开启之后,3D车头朝上、2D地图朝北模式会在路口处自动调整地图zoomlevel和overlooking,以提供最佳视野通过路口。
Definition: TNKTravelNavView.h:270
id< TNKDriveNavViewDelegate > delegate
TNKDriveNavView的回调,用于接收导航模式、日夜状态等变化.
Definition: TNKTravelNavView.h:29
BOOL withShowToast()
设置是否显示提示(包括GPS变弱、恢复,切换路线成功,手动刷新路线),默认NO. since 7.0.0
BOOL showBroadCastButton
是否显示语音播报按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:224
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:234
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:143
BOOL withShowExitButton()
是否显示退出按钮,链式调用,默认NO
BOOL withShowSmartLocView()
设置是否显示智能定位. 默认NO. since 7.0.0
BOOL withShowRoadTypeButton()
设置是否显示主辅路切换按钮,默认NO. since 7.0.0
BOOL showMapTrafficButton
是否显示切换实时路况的按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:214
BOOL guidedLaneEnabled
设置在3D车头朝上和2D地图朝北模式下 显示/隐藏路口车道线. 默认为YES 注意不管此参数如何设置,在全览模式和剩余全览模式下都会隐藏.
Definition: TNKTravelNavView.h:68
BOOL backupRouteBubbleHidden
设置隐藏备选路线上的气泡,默认为NO;
Definition: TNKTravelNavView.h:303
BOOL showGrossSpeedingView
是否展示严重超速视图,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:118
BOOL showDistanceOnCamera
电子眼上是否展示剩余距离。默认为NO
Definition: TNKTravelNavView.h:315
BOOL routeTrafficLightHidden
是否隐藏路线上的红绿灯,默认为NO。
Definition: TNKTravelNavView.h:292
CGFloat autoScaleMinZoomLevel
自动缩放比例尺功能中,可设置最小zoomlevel,默认15, 取值范围[14, 17] 。
Definition: TNKTravelNavView.h:276
BOOL withShowBottomToolbar()
是否显示底部工具栏,默认NO(包含退出、剩余距离时间、预计到达时间、设置)
BOOL withNavigationPanelEnabled()
设置是否展示顶部导航面板, 默认为YES since 7.0.0
BOOL trafficBubbleEnabled
设置显示/隐藏路况气泡.该方法用于导航状态下控制显示/隐藏导航路线上的路况气泡. 默认为YES 路况气泡在3D车头朝上和2D地图朝北模式下会显示, 在全览模式和剩余全览模式下会隐藏.
Definition: TNKTravelNavView.h:322
BOOL showOverviewButton
是否显示全览/退出全览切换按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:194
NSUInteger panelTopGap
导航面板顶部空隙距离. 默认为全屏状态下避开状态栏. 取值范围为[0,100].
Definition: TNKTravelNavView.h:37
BOOL withShowRouteRefreshButton()
设置是否显示路线刷新按钮,默认为NO. since 7.0.0
BOOL withShowBroadCastButton()
是否显示语音播报按钮,默认NO since 7.0.0
BOOL showSettingButton
是否显示设置按钮,默认NO,需在开启导航后设置
Definition: TNKTravelNavView.h:153
TNKNaviTrafficBarWidget * trafficBar
光柱图实例,当showTrafficBar为YES时才不为空
Definition: TNKTravelNavView.h:138
BOOL withShowTrafficBar()
设置是否显示路况光柱图,默认NO. since 7.0.0
BOOL withShowUIElements()
设置是否显示界面元素,默认NO。(不包含对导航面板的控制)since 7.0.0
BOOL shows3DBuildings
是否显示建筑物样式为3D效果,默认为NO。
Definition: TNKTravelNavView.h:286
BOOL withShowLimitSpeedAndCurrentRoadNameView()
设置是否显示限速、当前路名, 默认NO. since 7.0.0
BOOL showUIElements
是否显示界面元素,默认NO。(不包含对导航面板的控制),需在开启导航后设置
Definition: TNKTravelNavView.h:78
BOOL navigationPanelEnabled
是否展示顶部导航面板, 默认为YES
Definition: TNKTravelNavView.h:57
TNKTravelEnlargedMapConfig * enlargedMapConfig
放大图相关配置
Definition: TNKTravelNavView.h:328
BOOL showSmartLocView
是否显示智能定位. 默认NO. since 5.2.2
Definition: TNKTravelNavView.h:184
Definition: TNKUIComponentConfig.h:7
途经点配置类
Definition: TNKWaypointMarkerPresentation.h:16
驾车导航事件回调
Definition: TNKDriveNavDelegate.h:34