BaiduMap_IOSSDK_v8.0.0_Docs 8.0.0
载入中...
搜索中...
未找到
构造函数 | Protected 成员函数 | 属性 | 所有成员列表
BMKBackgroundNavigationView类 参考

#include <BMKBackgroundNavigationView.h>

类 BMKBackgroundNavigationView 继承关系图:

构造函数

(void) - updateRouteTrafficLightInfos:
 批量更新路线上所有红绿灯位置,用于路线绘制时一次性绘制全部红绿灯标签
 
(void) - updateTrafficLightData:
 
(void) - updateTrafficLightDatas:
 
(void) - updateRouteInfo:
 更新路线信息
 
(void) - updateRouteSegmentsInfo:
 更新分段路线信息,用于绘制路名等附加信息,必须与updateRouteInfo:方法中传入的路线数据一致
 
(void) - updateNaviLocationInfo:
 更新导航小车绑路后实时位置,方向及绑路后路线形状点索引
 
(void) - renderWithMapStatus:enable3D:fitScale:mapScreenExtOffset:
 渲染方法,缩放时起终点、途径点导航图标和罗盘保持原尺寸,路线,引导线保持原宽度
 

Protected 成员函数

(typedef) - NS_ENUM
 
(typedef) - NS_ENUM
 红绿灯气泡展示场景:决定 updateTrafficLightDatas: 传入的多灯按何种样式绘制
 

属性

id< BMKBackgroundNavigationViewDataSource > dataSource
 BMKBackgroundNavigationView的dataSource
 
BMKMapView * mapview
 关联源地图,用于同步数据
 
BOOL needDrawGuideLine
 是否支持绘制引导线(当前位置偏离路线时),默认NO
 
UIColor * guideLineColor
 引导线颜色,默认蓝色虚线
 
CGFloat guideLineWidth
 引导线线宽,默认2point,范围1~30point
 
BOOL needDrawRedLine
 是否支持绘制当前位置到终点的牵引红线(当前位置偏离路线时),默认NO
 
UIColor * redLineColor
 牵引线颜色,默认红色实线
 
CGFloat redLineWidth
 牵引线线宽,默认2point,范围1~30point
 
BOOL needDrawStartPoint
 设置是否绘制起点图标
 
CLLocationCoordinate2D startPoint
 设置起点经纬度位置
 
UIImage * startPointIcon
 设置起点图标
 
CGSize startPointIconSize
 设置起点图标尺寸,默认图片尺寸
 
CGPoint startPointIconOffset
 设置起点图标偏移量,默认图片底部中心在经纬度位置(0.0,-0.5),X轴负数向左,Y轴负数向上片,范围值-0.5~0.5
 
BOOL needDrawViaPoint
 设置是否绘制途径点图标
 
BMKViaPointPassedDisplayMode viaPointPassedDisplayMode
 设置已走过途径点绘制模式
 
NSArray< BMKNaviViaPointInfo * > * viaPoints
 设置途径点经纬度位置列表
 
UIImage * viaPointIcon
 设置途径点图标
 
UIImage * viaPassedPointIcon
 设置已走过途径点图标
 
CGSize viaPointIconSize
 设置途径点图标尺寸,默认图片尺寸
 
CGPoint viaPointIconOffset
 设置途径点图标偏移量,默认图片底部中心在经纬度位置(0.0,-0.5),X轴负数向左,Y轴负数向上片,范围值-0.5~0.5
 
BOOL needDrawEndPoint
 设置是否绘制终点图标
 
CLLocationCoordinate2D endPoint
 设置终点经纬度位置
 
UIImage * endPointIcon
 设置终点图标
 
CGSize endPointIconSize
 设置终点图标尺寸,默认图片尺寸
 
CGPoint endPointIconOffset
 设置终点图标偏移量,默认图片底部中心在经纬度位置(0.0,-0.5),X轴负数向左,Y轴负数向上片,范围值-0.5~0.5
 
UIImage * navigationIcon
 设置导航(小车)图标
 
CGSize navigationIconSize
 设置导航(小车)图标尺寸,默认图片尺寸
 
BOOL needFllowPhoneHeading
 是否展示用户实时方向,设置后会从dataSource获取实时数据
 
BOOL needDrawCompass
 是否支持绘制罗盘,默认NO
 
UIImage * compassIcon
 设置罗盘图标
 
CGSize compassIconSize
 设置罗盘图标尺寸,默认图片尺寸
 
UIColor * routeColor
 设置路线颜色,默认:#50D27D
 
CGFloat lineWidth
 设置路线线宽,默认:10point,范围1~30point
 
BMKRoutePassedDisplayMode routePassedDisplayMode
 走过路线绘制模式。默认BMKRoutePassedDisplayModeNone,无任何效果
 
UIColor * routePassedColor
 设置经过的路线颜色
 
NSArray< UIColor * > * trafficColor
 设置路线路况颜色数组,count必须为5,默认按顺序为未知:#0000FF 畅通:#50D27D 缓行:::FFD046 拥挤:::E72110 严重拥堵:::B4170A
 
BOOL needDrawTrafficLight
 是否绘制红绿灯倒计时气泡,默认NO
 
BOOL needDrawTrafficLightIcon
 是否绘制路线上的红绿灯图标(位置与气泡锚点一致),默认NO
 
NSArray< BMKNaviRouteTrafficLightInfo * > * routeTrafficLightInfos
 路线上全部红绿灯位置(由 updateRouteTrafficLightInfos: 批量设置)
 
BMKNaviTrafficLightBubbleDirection trafficLightPreferredDirection
 气泡首选方向,碰撞视图边界时自动 fallback,默认 TopRight
 
BMKNaviTrafficLightDisplayScene trafficLightScene
 
BOOL needDrawRouteName
 是否绘制路名,默认NO
 
CGFloat routeNameRepeatSpacing
 路名绘制重复间距,默认 150
 
UIFont * routeNameFont
 路名字体,默认[UIFont systemFontOfSize:10]
 
UIColor * routeNameTextColor
 路名颜色,默认 blackColor
 
UIColor * routeNameStrokeColor
 路名描边颜色,默认 whiteColor
 
CGFloat routeNameStrokeWidth
 路名描边宽度,默认 1.0
 

函数文档

◆ NS_ENUM [1/2]

- (typedef) NS_ENUM (NSInteger)
(BMKNaviTrafficLightBubbleDirection)  

< 气泡在锚点左上

< 气泡在锚点右上

< 气泡在锚点左下

< 气泡在锚点右下

◆ NS_ENUM [2/2]

- (typedef) NS_ENUM (NSInteger)
(BMKNaviTrafficLightDisplayScene)  

红绿灯气泡展示场景:决定 updateTrafficLightDatas: 传入的多灯按何种样式绘制

巡航态(默认):全部灯按"上图下字"紧凑气泡绘制,同锚点多灯并排聚合

导航态:每个路口按灯态样式绘制——正常灯"左灯右字"横向气泡、小灯"圆灯上加字", 支持多个路口同屏(如最近路口正常灯 + 较远路口小灯),同锚点多灯仍聚合为紧凑气泡

步骑行导航态:锚点红绿灯图标用 light_icon(与驾车导航态同图、锚点居中)。 实际接入走单灯入口 updateTrafficLightData:(见 BMKWalkGuideHandler),其恒为灯态样式, 单灯按 popType 绘制——Normal"左图右字" .9 图气泡、Small 圆灯、Big 大灯,同锚点多灯并排。 与驾车导航同为灯态样式,但步骑行用 .9 图背景,驾车用纯色气泡 + 连线。

◆ renderWithMapStatus:enable3D:fitScale:mapScreenExtOffset:

- (void) renderWithMapStatus: (BMKMapStatus *) mapstatus
enable3D: (BOOL) enable3D
fitScale: (CGFloat) fitScale
mapScreenExtOffset: (CGPoint) mapScreenExtOffset 

渲染方法,缩放时起终点、途径点导航图标和罗盘保持原尺寸,路线,引导线保持原宽度

◆ updateNaviLocationInfo:

- (void) updateNaviLocationInfo: (BMKNaviLocationInfo *) locationInfo

更新导航小车绑路后实时位置,方向及绑路后路线形状点索引

◆ updateRouteInfo:

- (void) updateRouteInfo: (BMKNaviRouteInfo *) routeInfo

更新路线信息

◆ updateRouteSegmentsInfo:

- (void) updateRouteSegmentsInfo: (NSArray< BMKNaviRouteSegmentInfo * > *) routeSegmentsInfo

更新分段路线信息,用于绘制路名等附加信息,必须与updateRouteInfo:方法中传入的路线数据一致

◆ updateRouteTrafficLightInfos:

- (void) updateRouteTrafficLightInfos: (nullable NSArray< BMKNaviRouteTrafficLightInfo * > *) infos

批量更新路线上所有红绿灯位置,用于路线绘制时一次性绘制全部红绿灯标签

◆ updateTrafficLightData:

- (void) updateTrafficLightData: (nullable BMKNaviTrafficLightData *) trafficLightData

更新单个红绿灯倒计时数据并触发重绘(单路口入口:单灯或左转双灯聚合展示)。 便捷入口,等价于向统一的多灯列表中按 lightType 增量更新本灯:

  • 单灯(Single)与左转双灯(TheFirst/TheSecond)互斥,自动覆盖;
  • 传 nil 清空全部红绿灯。 本入口始终按灯态样式绘制(单灯→左灯右字/圆灯上加字,同锚点双灯→紧凑并排),不受 trafficLightScene 影响。

◆ updateTrafficLightDatas:

- (void) updateTrafficLightDatas: (nullable NSArray< BMKNaviTrafficLightData * > *) trafficLightDatas

批量更新多个红绿灯倒计时数据并触发重绘(统一入口)。 支持沿路线多个路口同时展示,每个红绿灯按自身 anchorCoordinate 定位、各自独立倒计时; 同一锚点上的多个灯(如左转双灯)自动聚合为紧凑并排气泡。 传 nil 或空数组清空由本方法设置的全部红绿灯。 绘制样式由 trafficLightScene 决定:

  • Cruise(默认):全部"上图下字"紧凑气泡;
  • Navigation:每个路口按灯态样式绘制(正常灯左灯右字、小灯圆灯上加字),同锚点多灯仍紧凑并排。 注意:本方法与 updateTrafficLightData: 共享同一份数据与绘制管线,二者会相互覆盖,通常二选一使用。

属性说明

◆ compassIcon

- (UIImage*) compassIcon
readwritenonatomicstrong

设置罗盘图标

◆ compassIconSize

- (CGSize) compassIconSize
readwritenonatomicassign

设置罗盘图标尺寸,默认图片尺寸

◆ dataSource

- (id<BMKBackgroundNavigationViewDataSource>) dataSource
readwritenonatomicweak

BMKBackgroundNavigationView的dataSource

◆ endPoint

- (CLLocationCoordinate2D) endPoint
readwritenonatomicassign

设置终点经纬度位置

◆ endPointIcon

- (UIImage*) endPointIcon
readwritenonatomicstrong

设置终点图标

◆ endPointIconOffset

- (CGPoint) endPointIconOffset
readwritenonatomicassign

设置终点图标偏移量,默认图片底部中心在经纬度位置(0.0,-0.5),X轴负数向左,Y轴负数向上片,范围值-0.5~0.5

◆ endPointIconSize

- (CGSize) endPointIconSize
readwritenonatomicassign

设置终点图标尺寸,默认图片尺寸

◆ guideLineColor

- (UIColor*) guideLineColor
readwritenonatomicstrong

引导线颜色,默认蓝色虚线

◆ guideLineWidth

- (CGFloat) guideLineWidth
readwritenonatomicassign

引导线线宽,默认2point,范围1~30point

◆ lineWidth

- (CGFloat) lineWidth
readwritenonatomicassign

设置路线线宽,默认:10point,范围1~30point

◆ mapview

- (BMKMapView*) mapview
readwritenonatomicweak

关联源地图,用于同步数据

◆ navigationIcon

- (UIImage*) navigationIcon
readwritenonatomicstrong

设置导航(小车)图标

◆ navigationIconSize

- (CGSize) navigationIconSize
readwritenonatomicassign

设置导航(小车)图标尺寸,默认图片尺寸

◆ needDrawCompass

- (BOOL) needDrawCompass
readwritenonatomicassign

是否支持绘制罗盘,默认NO

◆ needDrawEndPoint

- (BOOL) needDrawEndPoint
readwritenonatomicassign

设置是否绘制终点图标

◆ needDrawGuideLine

- (BOOL) needDrawGuideLine
readwritenonatomicassign

是否支持绘制引导线(当前位置偏离路线时),默认NO

◆ needDrawRedLine

- (BOOL) needDrawRedLine
readwritenonatomicassign

是否支持绘制当前位置到终点的牵引红线(当前位置偏离路线时),默认NO

◆ needDrawRouteName

- (BOOL) needDrawRouteName
readwritenonatomicassign

是否绘制路名,默认NO

◆ needDrawStartPoint

- (BOOL) needDrawStartPoint
readwritenonatomicassign

设置是否绘制起点图标

◆ needDrawTrafficLight

- (BOOL) needDrawTrafficLight
readwritenonatomicassign

是否绘制红绿灯倒计时气泡,默认NO

◆ needDrawTrafficLightIcon

- (BOOL) needDrawTrafficLightIcon
readwritenonatomicassign

是否绘制路线上的红绿灯图标(位置与气泡锚点一致),默认NO

◆ needDrawViaPoint

- (BOOL) needDrawViaPoint
readwritenonatomicassign

设置是否绘制途径点图标

◆ needFllowPhoneHeading

- (BOOL) needFllowPhoneHeading
readwritenonatomicassign

是否展示用户实时方向,设置后会从dataSource获取实时数据

◆ redLineColor

- (UIColor*) redLineColor
readwritenonatomicstrong

牵引线颜色,默认红色实线

◆ redLineWidth

- (CGFloat) redLineWidth
readwritenonatomicassign

牵引线线宽,默认2point,范围1~30point

◆ routeColor

- (UIColor*) routeColor
readwritenonatomicstrong

设置路线颜色,默认:#50D27D

◆ routeNameFont

- (UIFont*) routeNameFont
readwritenonatomicstrong

路名字体,默认[UIFont systemFontOfSize:10]

◆ routeNameRepeatSpacing

- (CGFloat) routeNameRepeatSpacing
readwritenonatomicassign

路名绘制重复间距,默认 150

◆ routeNameStrokeColor

- (UIColor*) routeNameStrokeColor
readwritenonatomicstrong

路名描边颜色,默认 whiteColor

◆ routeNameStrokeWidth

- (CGFloat) routeNameStrokeWidth
readwritenonatomicassign

路名描边宽度,默认 1.0

◆ routeNameTextColor

- (UIColor*) routeNameTextColor
readwritenonatomicstrong

路名颜色,默认 blackColor

◆ routePassedColor

- (UIColor*) routePassedColor
readwritenonatomicstrong

设置经过的路线颜色

◆ routePassedDisplayMode

- (BMKRoutePassedDisplayMode) routePassedDisplayMode
readwritenonatomicassign

走过路线绘制模式。默认BMKRoutePassedDisplayModeNone,无任何效果

◆ routeTrafficLightInfos

- (NSArray<BMKNaviRouteTrafficLightInfo *>*) routeTrafficLightInfos
readwritenonatomiccopy

路线上全部红绿灯位置(由 updateRouteTrafficLightInfos: 批量设置)

◆ startPoint

- (CLLocationCoordinate2D) startPoint
readwritenonatomicassign

设置起点经纬度位置

◆ startPointIcon

- (UIImage*) startPointIcon
readwritenonatomicstrong

设置起点图标

◆ startPointIconOffset

- (CGPoint) startPointIconOffset
readwritenonatomicassign

设置起点图标偏移量,默认图片底部中心在经纬度位置(0.0,-0.5),X轴负数向左,Y轴负数向上片,范围值-0.5~0.5

◆ startPointIconSize

- (CGSize) startPointIconSize
readwritenonatomicassign

设置起点图标尺寸,默认图片尺寸

◆ trafficColor

- (NSArray<UIColor *>*) trafficColor
readwritenonatomicstrong

设置路线路况颜色数组,count必须为5,默认按顺序为未知:#0000FF 畅通:#50D27D 缓行:::FFD046 拥挤:::E72110 严重拥堵:::B4170A

◆ trafficLightPreferredDirection

- (BMKNaviTrafficLightBubbleDirection) trafficLightPreferredDirection
readwritenonatomicassign

气泡首选方向,碰撞视图边界时自动 fallback,默认 TopRight

◆ trafficLightScene

- (BMKNaviTrafficLightDisplayScene) trafficLightScene
readwritenonatomicassign

红绿灯气泡展示场景,默认 BMKNaviTrafficLightDisplaySceneCruise(巡航:上图下字紧凑气泡)。 导航态设为 BMKNaviTrafficLightDisplaySceneNavigation,使 updateTrafficLightDatas: 的多灯按 灯态样式绘制(正常灯左灯右字 + 小灯圆灯上加字)。仅影响 updateTrafficLightDatas: 入口; updateTrafficLightData: 单灯入口始终按灯态样式绘制,不受此属性影响。 步骑行导航设为 BMKNaviTrafficLightDisplaySceneWalkRideNavigation:锚点红绿灯图标使用 light_icon(而非巡航态的 light_icon_cruise)。步骑行实际接入走 updateTrafficLightData: 单灯入口,恒为灯态样式(单灯左图右字/圆灯);若改用 updateTrafficLightDatas:,因该场景 非 Navigation 会退回"上图下字"紧凑气泡。

◆ viaPassedPointIcon

- (UIImage*) viaPassedPointIcon
readwritenonatomicstrong

设置已走过途径点图标

◆ viaPointIcon

- (UIImage*) viaPointIcon
readwritenonatomicstrong

设置途径点图标

◆ viaPointIconOffset

- (CGPoint) viaPointIconOffset
readwritenonatomicassign

设置途径点图标偏移量,默认图片底部中心在经纬度位置(0.0,-0.5),X轴负数向左,Y轴负数向上片,范围值-0.5~0.5

◆ viaPointIconSize

- (CGSize) viaPointIconSize
readwritenonatomicassign

设置途径点图标尺寸,默认图片尺寸

◆ viaPointPassedDisplayMode

- (BMKViaPointPassedDisplayMode) viaPointPassedDisplayMode
readwritenonatomicassign

设置已走过途径点绘制模式

◆ viaPoints

- (NSArray<BMKNaviViaPointInfo *>*) viaPoints
readwritenonatomiccopy

设置途径点经纬度位置列表


该类的文档由以下文件生成: