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 showLimitSpeedAndCurrentRoadNameView;
154
159
163@property (nonatomic, assign) BOOL showSmartLocView;
164
169
173@property (nonatomic, assign) BOOL showOverviewButton;
174
179
183@property (nonatomic, assign) BOOL showRouteRefreshButton;
184
189
193@property (nonatomic, assign) BOOL showMapTrafficButton;
194
199
203@property (nonatomic, assign) BOOL showBroadCastButton;
204
209
213@property (nonatomic, assign) BOOL showServiceAreaInfo;
214
219
223- (void)setAllComponentVisibility:(BOOL)visible;
224
229- (TNKTravelNavView *(^)(void))build;
230
234- (void)setUIComponentConfig:(TNKUIComponentConfig *)uiComponentConfig;
235
240
241//**************** 导航界面元素控制-结束 ****************//
242
243
249@property (nonatomic, getter=isAutoScaleEnabled) BOOL autoScaleEnabled;
250
255@property (nonatomic, assign) CGFloat autoScaleMinZoomLevel;
256
260@property (nonatomic, assign) BOOL showTraffic;
261
265@property (nonatomic, assign) BOOL shows3DBuildings;
266
271@property (nonatomic, assign) BOOL routeTrafficLightHidden;
272
277@property (nonatomic, assign) BOOL lightCountDownTimerHidden;
278
282@property (nonatomic, assign) BOOL backupRouteBubbleHidden;
283
288@property (nonatomic, assign) BOOL cameraMarkerEnabled;
289
294@property (nonatomic, assign) BOOL showDistanceOnCamera;
295
301@property (nonatomic, assign) BOOL trafficBubbleEnabled;
302
307@property (nonatomic, readonly) TNKTravelEnlargedMapConfig *enlargedMapConfig;
308
309
313@property (nonatomic, strong, readonly) TNKCustomAreaView *customAreaView;
314
318- (void)setCustomAreaHeight:(CGFloat)height;
319
320
326- (void)updateEnlargedMapConfig:(TNKTravelEnlargedMapConfig *)enlargedMapConfig;
327
333
341- (void)updateWaypointMarkerPresentation:(NSDictionary<NSString *, TNKWaypointMarkerPresentation *> * _Nullable)waypointMarkerPresentationDictionary;
342
349- (void)setBackupRoutesHidden:(BOOL)hidden backupRouteIDs:(NSArray<NSString *> * _Nullable)backupRouteIDs;
350
351
352- (void)createExitNaviAlert;
353
354- (void)removeCustomView;
355
356@end
357
358NS_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 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:313
BOOL withShowMapTrafficButton()
是否显示切换实时路况的按钮,默认NO. since 7.0.0
BOOL lightCountDownTimerHidden
是否隐藏路线上的红绿灯倒计时,默认为NO。
Definition: TNKTravelNavView.h:277
BOOL withShowServiceAreaInfo()
是否显示高速休息区信息,默认NO since 7.0.0
BOOL showTraffic
设置导航地图是否显示实时路况,不影响showMapTrafficButton的逻辑,默认为YES。
Definition: TNKTravelNavView.h:260
NSUInteger panelButtomGap
导航面板底部空隙距离. 预留给业务使用的区域. 默认值0, 取值范围[0,.
Definition: TNKTravelNavView.h:42
BOOL withShowGrossSpeedingView()
设置是否展示严重超速视图,默认NO. since 7.0.0
BOOL cameraMarkerEnabled
设置是否展示路线上的电子眼.默认值为YES。 电子眼标识在3D车头朝上和2D地图朝北模式下会默认显示, 在全览模式和剩余全览模式下会隐藏.
Definition: TNKTravelNavView.h:288
BOOL showLimitSpeedAndCurrentRoadNameView
是否显示限速、当前路名, 默认NO
Definition: TNKTravelNavView.h:153
BOOL showRouteRefreshButton
是否显示路线刷新按钮,默认为NO. since 5.2.5
Definition: TNKTravelNavView.h:183
TNKUIComponentConfig * getUIComponentConfig()
BOOL autoScaleEnabled
设置导航地图是否开启自动缩放比例尺功能,默认开启。 开启之后,3D车头朝上、2D地图朝北模式会在路口处自动调整地图zoomlevel和overlooking,以提供最佳视野通过路口。
Definition: TNKTravelNavView.h:249
id< TNKDriveNavViewDelegate > delegate
TNKDriveNavView的回调,用于接收导航模式、日夜状态等变化.
Definition: TNKTravelNavView.h:29
BOOL withShowToast()
设置是否显示提示(包括GPS变弱、恢复,切换路线成功,手动刷新路线),默认NO. since 7.0.0
BOOL showBroadCastButton
是否显示语音播报按钮,默认NO
Definition: TNKTravelNavView.h:203
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:213
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 withShowSmartLocView()
设置是否显示智能定位. 默认NO. since 7.0.0
BOOL withShowRoadTypeButton()
设置是否显示主辅路切换按钮,默认NO. since 7.0.0
BOOL showMapTrafficButton
是否显示切换实时路况的按钮,默认NO
Definition: TNKTravelNavView.h:193
BOOL guidedLaneEnabled
设置在3D车头朝上和2D地图朝北模式下 显示/隐藏路口车道线. 默认为YES 注意不管此参数如何设置,在全览模式和剩余全览模式下都会隐藏.
Definition: TNKTravelNavView.h:68
BOOL backupRouteBubbleHidden
设置隐藏备选路线上的气泡,默认为NO;
Definition: TNKTravelNavView.h:282
BOOL showGrossSpeedingView
是否展示严重超速视图,默认NO
Definition: TNKTravelNavView.h:118
BOOL showDistanceOnCamera
电子眼上是否展示剩余距离。默认为NO
Definition: TNKTravelNavView.h:294
BOOL routeTrafficLightHidden
是否隐藏路线上的红绿灯,默认为NO。
Definition: TNKTravelNavView.h:271
CGFloat autoScaleMinZoomLevel
自动缩放比例尺功能中,可设置最小zoomlevel,默认15, 取值范围[14, 17] 。
Definition: TNKTravelNavView.h:255
BOOL withShowBottomToolbar()
是否显示底部工具栏,默认NO(包含退出、剩余距离时间、预计到达时间、设置)
BOOL withNavigationPanelEnabled()
设置是否展示顶部导航面板, 默认为YES since 7.0.0
BOOL trafficBubbleEnabled
设置显示/隐藏路况气泡.该方法用于导航状态下控制显示/隐藏导航路线上的路况气泡. 默认为YES 路况气泡在3D车头朝上和2D地图朝北模式下会显示, 在全览模式和剩余全览模式下会隐藏.
Definition: TNKTravelNavView.h:301
BOOL showOverviewButton
是否显示全览/退出全览切换按钮,默认NO
Definition: TNKTravelNavView.h:173
NSUInteger panelTopGap
导航面板顶部空隙距离. 默认为全屏状态下避开状态栏. 取值范围为[0,100].
Definition: TNKTravelNavView.h:37
BOOL withShowRouteRefreshButton()
设置是否显示路线刷新按钮,默认为NO. since 7.0.0
BOOL withShowBroadCastButton()
是否显示语音播报按钮,默认NO since 7.0.0
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:265
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:307
BOOL showSmartLocView
是否显示智能定位. 默认NO. since 5.2.2
Definition: TNKTravelNavView.h:163
Definition: TNKUIComponentConfig.h:7
途经点配置类
Definition: TNKWaypointMarkerPresentation.h:16
驾车导航事件回调
Definition: TNKDriveNavDelegate.h:34