{"version":"0.1.0","code":"0000","result":true,"message":"处理成功","errdetail":"","timestamp":1671508860952,"data":{"id":71713130,"title":"6.4.6扎标业务图层控制器","slug":"zyo37n","format":"lake","bookId":26046811,"body":null,"body_draft":null,"body_html":"

基本介绍

扎标业务图层控制器主要是关于描述扎标相关场景的图层，比如巡航车道线扎标图层、分歧路口扎标图层、巡航拥堵加粗图层、路径上弹出添加途径点图层、路径上弹出移除途径点图层、路径上弹出交通事件图层、路径上弹出搜索点图层、终点区域弹出框图层、GPS轨迹点等业务图层。

场景图

巡航车道线扎标图层

前序文档：巡航车道线
图层支持内聚，图层默认显示比例尺为[500M, 25M]
该图层用于展示巡航车道线在地图上的位置

$\"image.png\"$

分歧路口扎标图层

前序文档：引导混淆路口
图层不可点击，图层支持内聚，图层默认显示比例尺为[200M, 10M]
该图层用于展示分歧路口信息

$\"image.png\"$

巡航拥堵加粗图层

前序文档：巡航拥堵路况
图层不可点击，图层支持内聚
该图层为线图层，巡航拥堵信息通过该图层进行展示

$\"image.png\"$

路径上弹出添加途径点图层

用于添加途经点的弹出扎标使用该图层进行展示

$\"image.png\"$

路径上弹出移除途径点图层

用于移除途经点的弹出扎标使用该图层进行展示

$\"image.png\"$

路径上弹出交通事件图层

$\"image.png\"$

路径上弹出搜索点图层

无示例图

终点区域弹出框图层

终点区域的弹出扎标使用该图层进行展示

$\"image.png\"$

GPS轨迹点图层

传入GPS轨迹点，使用该图层进行展示

$\"image.png\"$

时序图

参考概述

关键参数

Biz扎标图层业务类型定义

com.autonavi.gbl.layer.model.BizLabelType类

一级分类	业务图层	枚举类型	图元或者图层类型	对应图元Item	是否内聚	是否动态纹理
扎标	巡航车道线图层	BizLabelTypeCruiseLane	点图元	PointLayerItem	是	无
巡航拥堵加粗图层	BizLabelTypeCruiseCongestion	线图元	CruiseCongestionItem	是	否
分歧路口图层	BizLabelTypeGuideMixFork	点图元	GuideMixForkLayerItem	是	否
路径上弹出添加途径点图层	BizLabelTypeRoutePopAddViaPoint	点图元	SearchAlongWayLayerItem	否	是
路径上弹出移除途径点图层	BizLabelTypeRoutePopRemoveViaPoint	点图元	PopPointLayerItem	否	是
路径上弹出交通事件图层	BizLabelTypeRoutePopTrafficEvent	点图元	PopPointLayerItem	否	无
路径上弹出搜索点图层	BizLabelTypeRoutePopSearchPoint	点图元	PopPointLayerItem	否	无
终点区域弹出框图层	BizLabelTypeRoutePopEndArea	点图元	PopPointLayerItem	否	是
GPS轨迹点图层	BizLabelTypeGpsPoints	点图元	PointLayerItem	否	否

核心接口

/* 更新引导信息 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updateNaviInfo(NaviInfo naviInfo)\n\n/* 获取扎标类具体业务图层 */\nBaseLayer com.autonavi.gbl.layer.BizLabelControl.getLabelLayer(@BizLabelType.BizLabelType1 int eType)\n\n/* 更新巡航车道扎标 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updateCruiseLane(LaneInfo info)\n\n/* 导航分歧路口扎标 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updateGuideMixForkInfo(ArrayList< MixForkInfo > vecMixForkInfo)\n\n/* 更新巡航拥堵信息，加粗显示 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updateCruiseCongestion(CruiseCongestionInfo congestInfo, int boldDistance, int clearDistance, int maxLevel)\n\n/* 巡航拥堵加粗全览 */\nvoid com.autonavi.gbl.layer.BizLabelControl.previewCruiseCongestion(CruiseCongestionInfo Info, boolean bMoveCenter, boolean isAnimation)\n\n/* 巡航拥堵加粗退出全览 */\nvoid com.autonavi.gbl.layer.BizLabelControl.exitPreviewCruiseCongestion()\n\n/* 更新添加中途点弹出框 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updatePopAddViaPointInfo(ArrayList< BizSearchAlongWayPoint > pointList)\n\n/* 更新删除中途点弹出框 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updatePopRemoveViaPointInfo(ArrayList< BizPopPointBusinessInfo > pointList)\n\n/* 更新交通事件弹出框 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updatePopTrafficEventInfo(ArrayList< BizPopPointBusinessInfo > pointList)\n\n/* 更新搜索弹出框 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updatePopSearchPointInfo(ArrayList< BizPopPointBusinessInfo > pointList)\n\n/* 更新终点区域弹出框 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updatePopEndAreaPointBoxInfo(ArrayList< BizPopPointBusinessInfo > pointList)\n\n/* 更新GPS轨迹点 */\nvoid com.autonavi.gbl.layer.BizLabelControl.updateGpsPointsInfo(ArrayList< BizPointBusinessInfo > pointList)

说明：函数详情，请复制函数名称到在线API搜索

调用示例

巡航车道线扎标图层（非内聚用法）

public abstract class BaseTbtActivity extends BaseMapActivity implements\n        INaviObserver, xxx\n{\n    /**\n     * 显示巡航车道信息\n     *\n     * @details 巡航过程中传出巡航车道信息\n     * @param[in] info             行车引导线信息\n     * @remark 1、只有auto项目开关(默认为关闭状态)开启才会回调\n     * @remark 2、需要有离线数据，并且定位匹配到道路\n     * @note thread mutilini\n     * @note BL有内聚\n     */\n    @Override\n    public void onShowCruiseLaneInfo(final LaneInfo info) {\n        if (info != null) {\n            //需要切换到UI线程显示巡航车道信息\n            sendBizMessage(new Runnable() {\n                @Override\n                public void run() {\n                    bizLabelControl.updateCruiseLane(info);\n                }\n            });\n        }\n    }\n}

分歧路口扎标图层（非内聚用法）

public abstract class BaseTbtActivity extends BaseMapActivity implements\n        INaviObserver, xxx\n{\n    /**\n     * 透出混淆路口信息\n     *\n     * @details 透出混淆路口信息\n     * @param[in] list             混淆路口信息列表\n     * @remark 通知距离导航路口最近的容易混淆的路口信息\n     * @note thread mutil\n     * @note BL内聚\n     */\n    @Override\n    public void onShowSameDirectionMixForkInfo(final ArrayList<MixForkInfo> list) {\n        int size = list == null ? 0 : list.size();\n        if (size > 0) {\n            //需要切换到UI线程显示分歧路口信息\n            sendBizMessage(new Runnable() {\n                @Override\n                public void run() {\n                    bizLabelControl.updateGuideMixForkInfo(list);\n                }\n            });\n        }\n    }\n}

巡航拥堵加粗图层（非内聚用法）

public abstract class BaseTbtActivity extends BaseMapActivity implements\n        INaviObserver, xxx\n{\n    /**\n     * 传出巡航状态下的拥堵区域信息\n     *\n     * @details 巡航过程中传出巡航状态下的拥堵区域信息\n     * @param[in] info             拥堵区域信息\n     * @remark 1、需开启非导航电子狗开关，通过startNavi(NaviTypeCruise)开启，需与stopNavi配对\n     * @remark 2、在线情况下；3、目前auto在导航下会用到事件的部分信息，所以导航下也会回到；\n     * @note thread mutil\n     * @note BL有内聚\n     */\n    @Override\n    public void onUpdateCruiseCongestionInfo(final CruiseCongestionInfo info) {\n        if (info != null) {\n            //需要切换到UI线程显示巡航拥堵信息\n            sendBizMessage(new Runnable() {\n                @Override\n                public void run() {\n                    bizLabelControl.updateCruiseCongestion(info, 700, 500, 18);\n                }\n            });\n        }\n    }\n}

路径上弹出添加途径点图层

ArrayList<BizSearchAlongWayPoint> viaPonints = new ArrayList<>();\nBizSearchAlongWayPoint viaPoint1 = new BizSearchAlongWayPoint();\nviaPoint1.name = "特斯拉汽车充电站(望京SOHO中心T1)";\nviaPoint1.typeCode = 011100;\nviaPoint1.searchType = 1;\nviaPoint1.labelType = 0;\nviaPoint1.mPos3D.lat = 39.99688;\nviaPoint1.mPos3D.lon = 116.48128;\nviaPonints.add(viaPoint1);\n//显示路径上弹出添加途径点图层\nbizLabelControl.updatePopAddViaPointInfo(viaPonints);

路径上弹出移除途径点图层

ArrayList<BizPopPointBusinessInfo> removeVias = new ArrayList<>();\nBizPopPointBusinessInfo removeVia = new BizPopPointBusinessInfo();\nremoveVia.text = "delVia";\nremoveVia.mPos3D.lat = 39.979213;\nremoveVia.mPos3D.lon = 116.460557; //宜家家居\nremoveVias.add(removeVia);\n//显示路径上弹出移除途径点图层\nbizLabelControl.updatePopRemoveViaPointInfo(removeVias);

路径上弹出交通事件图层

ArrayList<BizPopPointBusinessInfo> popTraffics = new ArrayList<>();\nBizPopPointBusinessInfo popTraffic = new BizPopPointBusinessInfo();\npopTraffic.text = "trafficevent";\npopTraffic.mPos3D.lat = 39.936581;\npopTraffic.mPos3D.lon = 116.456437; //三里屯116.456437,39.936581\npopTraffics.add(popTraffic);\n//显示路径上弹出交通事件图层\nbizLabelControl.updatePopTrafficEventInfo(popTraffics);

路径上弹出搜索点图层

ArrayList<BizPopPointBusinessInfo> popSearchs = new ArrayList<>();\nBizPopPointBusinessInfo popSearch = new BizPopPointBusinessInfo();\npopSearch.text = "searchpop";\npopSearch.mPos3D.lat = 39.98579;\npopSearch.mPos3D.lon = 116.493859; //北京798艺术区 116.493859,39.98579\npopSearchs.add(popSearch);\n//显示路径上弹出搜索点图层\nbizLabelControl.updatePopSearchPointInfo(popSearchs);

终点区域弹出框图层

ArrayList<BizPopPointBusinessInfo> popEnds = new ArrayList<>();\nBizPopPointBusinessInfo popEnd = new BizPopPointBusinessInfo();\npopEnd.text = "endpop";\npopEnd.mPos3D.lat = 39.908144;\npopEnd.mPos3D.lon = 116.396699; //天安门 116.396699,39.908144\npopEnds.add(popEnd);\n//显示终点区域弹出框图层\nbizLabelControl.updatePopEndAreaPointBoxInfo(popEnds);

GPS轨迹点图层

ArrayList<BizPopPointBusinessInfo> gpsList = new ArrayList<>();\nBizPopPointBusinessInfo gpsPoint = new BizPopPointBusinessInfo();\ngpsPoint.text = "gps1";\ngpsPoint.mPos3D.lat = 39.908144;\ngpsPoint.mPos3D.lon = 116.396699; //天安门 116.396699,39.908144\ngpsList.add(gpsPoint);\ngpsPoint.text = "gps2";\ngpsPoint.mPos3D.lat = 39.908146;\ngpsPoint.mPos3D.lon = 116.396699;\ngpsList.add(gpsPoint);\ngpsPoint.text = "gps3";\ngpsPoint.mPos3D.lat = 39.908148;\ngpsPoint.mPos3D.lon = 116.396699;\ngpsList.add(gpsPoint);\n//显示GPS轨迹点图层\nbizLabelControl.updateGpsPointsInfo(gpsList);

JSON配置

巡航车道线扎标图层（示例）

  "point_cruise_lane": {\n    "point_layer_item_style": {\n      "normal_style": {\n        "poi_marker_id": 2007\n      }\n    }\n  },

分歧路口扎标图层（示例）

\t\t"point_guide_mix_fork_left_day1": {\n\t\t\t"point_layer_item_style": {\n\t\t\t\t"normal_style": {\n\t\t\t\t\t"poi_marker_id": "global_image_navi_mix_fork_marker_left_day1",\n\t\t\t\t\t"poi_marker_info": "mix_fork_left_x_y"\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t"point_guide_mix_fork_right_day1": {\n\t\t\t"point_layer_item_style": {\n\t\t\t\t"normal_style": {\n\t\t\t\t\t"poi_marker_id": "global_image_navi_mix_fork_marker_right_day1",\n\t\t\t\t\t"poi_marker_info": "mix_fork_right_x_y"\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t"mix_fork_left_x_y": {\n            "anchor": 9,\n            "x_ratio": 0.926,\n            "y_ratio": 0.392\n        },\n\t\t"mix_fork_right_x_y": {\n            "anchor": 9,\n            "x_ratio": 0.074,\n            "y_ratio": 0.392\n        },\n

巡航拥堵加粗图层（示例）

\t\t"cruise_congestion_slow": {\n\t\t\t"line_layer_item_style": {\n\t\t\t\t"priority": 0,\n\t\t\t\t"use_cap": 1,\n\t\t\t\t"use_color": 1,\n\t\t\t\t"draw_cover": 1,\n\t\t\t\t"can_be_coveredbylabel": 0,\n\t\t\t\t"fill_texture": {\n\t\t\t\t\t"marker_id": "map_lr_slow",\n\t\t\t\t\t"color": "0xFFFFFFFFF",\n\t\t\t\t\t"width": 20\n\t\t\t\t},\n\t\t\t\t"texture_info": {\n\t\t\t\t\t"x1": 0,\n\t\t\t\t\t"y1": 0.5,\n\t\t\t\t\t"x2": 1,\n\t\t\t\t\t"y2": 0.5,\n\t\t\t\t\t"texture_len": 32\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t"cruise_congestion_feeroad": {\n\t\t\t"line_layer_item_style": {\n\t\t\t\t"priority": 0,\n\t\t\t\t"use_cap": 1,\n\t\t\t\t"use_color": 1,\n\t\t\t\t"draw_cover": 1,\n\t\t\t\t"can_be_coveredbylabel": 0,\n\t\t\t\t"fill_texture": {\n\t\t\t\t\t"marker_id": "map_lr_feeroad",\n\t\t\t\t\t"color": "0xFFFFFFFFF",\n\t\t\t\t\t"width": 20\n\t\t\t\t},\n\t\t\t\t"texture_info": {\n\t\t\t\t\t"x1": 0,\n\t\t\t\t\t"y1": 0.5,\n\t\t\t\t\t"x2": 1,\n\t\t\t\t\t"y2": 0.5,\n\t\t\t\t\t"texture_len": 32\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t"cruise_congestion_bad": {\n\t\t\t"line_layer_item_style": {\n\t\t\t\t"priority": 0,\n\t\t\t\t"use_cap": 1,\n\t\t\t\t"use_color": 1,\n\t\t\t\t"draw_cover": 1,\n\t\t\t\t"can_be_coveredbylabel": 0,\n\t\t\t\t"fill_texture": {\n\t\t\t\t\t"marker_id": "lr_bad",\n\t\t\t\t\t"color": "0xFFFFFFFFF",\n\t\t\t\t\t"width": 20\n\t\t\t\t},\n\t\t\t\t"texture_info": {\n\t\t\t\t\t"x1": 0,\n\t\t\t\t\t"y1": 0.5,\n\t\t\t\t\t"x2": 1,\n\t\t\t\t\t"y2": 0.5,\n\t\t\t\t\t"texture_len": 32\n\t\t\t\t}\n\t\t\t}\n\t\t},

路径上弹出添加途径点图层（示例）

\t\t"route_popup_label_nearest":\n\t\t{\n\t\t\t"marker_id":"id_route_popup_dynamic",\n\t\t\t"background_res":"global_image_route_along_search_mid_tip_add_day_night",\n\t\t\t"popup_res":"global_image_bubble_child_day_night",\n\t\t\t"popup_position":"bottom",\n\t\t\t"text_colour":"0xff000000",\n\t\t\t"font_size":"24",\n\t\t\t"text_top":"26",\n\t\t\t"text_bottom":"64",\n\t\t\t"text_left_offset":"64",\n\t\t\t"text_right_offset":"20",\n\t\t\t"text_max_lenth":"192",\n\t\t\t"ignore_adjust_hight":"17",\n\t\t\t"background_adjust_down":"18",\n\t\t\t"halign_type":"",\n\t\t\t"arrowx_offset":"",\n\t\t\t"arrowy_offset":"50",\n\t\t\t"icon_res":"",\n\t\t\t"icon_width":"",\n\t\t\t"icon_height":"",\n\t\t\t"text_icon_dis":"",\n\t\t\t"x_ratio":"0.5",\n\t\t\t"y_ratio":"0.88",\n\t\t\t"background_top":"1"\n\t\t},

路径上弹出删除途径点图层（示例）

\t\t"route_popup_label_nearest":\n\t\t{\n\t\t\t"marker_id":"id_route_popup_dynamic",\n\t\t\t"background_res":"global_image_route_along_search_mid_tip_add_day_night",\n\t\t\t"popup_res":"global_image_bubble_child_day_night",\n\t\t\t"popup_position":"bottom",\n\t\t\t"text_colour":"0xff000000",\n\t\t\t"font_size":"24",\n\t\t\t"text_top":"26",\n\t\t\t"text_bottom":"64",\n\t\t\t"text_left_offset":"64",\n\t\t\t"text_right_offset":"20",\n\t\t\t"text_max_lenth":"192",\n\t\t\t"ignore_adjust_hight":"17",\n\t\t\t"background_adjust_down":"18",\n\t\t\t"halign_type":"",\n\t\t\t"arrowx_offset":"",\n\t\t\t"arrowy_offset":"50",\n\t\t\t"icon_res":"",\n\t\t\t"icon_width":"",\n\t\t\t"icon_height":"",\n\t\t\t"text_icon_dis":"",\n\t\t\t"x_ratio":"0.5",\n\t\t\t"y_ratio":"0.88",\n\t\t\t"background_top":"1"\n\t\t},

路径上弹出交通事件图层（示例）

  "point_route_pop_traffic_event": {\n    "point_layer_item_style": {\n      "normal_style": {\n        "poi_marker_id": 1009\n      }\n    }\n  },

路径上弹出搜索点图层（示例）

  "point_route_pop_search": {\n    "point_layer_item_style": {\n      "normal_style": {\n        "poi_marker_id": 1010\n      }\n    }\n  },

终点区域弹出框图层（示例）

       "point_end_area_pop_point": {\n          "point_layer_item_style": {\n            "normal_style": {\n              "poi_marker_id": "global_image_hawkeye_end"\n            }\n          }\n        },

GPS轨迹点图层（示例）

\t\t"gps_points": {\n\t\t\t"point_layer_item_style": {\n\t\t\t\t"normal_style": {\n\t\t\t\t\t"poi_marker_id": "measure_point_red"\n\t\t\t\t}\n\t\t\t}\n\t\t},

注意事项

1、巡航车道线扎标图层内聚能力

巡航车道线扎标内聚能力是在json中配置的。关键参数为"virtual_bus"中的"cruise_lane_layer"。为1表示内聚能力打开，为0表示内聚能力关闭。该json内容在strJsonFilename中描述

/* 初始化业务图层优先级配置及内聚功能配置 */

boolean com.autonavi.gbl.layer.BizControlService.init(@MapEngineID.MapEngineID1 int engineId, String strJsonFilename)

$\"image.png\"$

2、分歧路口扎标图层内聚能力

分歧路口扎标内聚能力是在json中配置的。关键参数为"virtual_bus"中的"guide_mix_fork_layer"。为1表示内聚能力打开，为0表示内聚能力关闭。该json内容在strJsonFilename中描述

/* 初始化业务图层优先级配置及内聚功能配置 */

boolean com.autonavi.gbl.layer.BizControlService.init(@MapEngineID.MapEngineID1 int engineId, String strJsonFilename)

$\"image.png\"$

3、巡航拥堵加粗图层内聚能力

巡航拥堵加粗内聚能力是在json中配置的。关键参数为"virtual_bus"中的"cruise_congestion_layer"。为1表示内聚能力打开，为0表示内聚能力关闭。该json内容在strJsonFilename中描述

/* 初始化业务图层优先级配置及内聚功能配置 */

boolean com.autonavi.gbl.layer.BizControlService.init(@MapEngineID.MapEngineID1 int engineId, String strJsonFilename)

$\"image.png\"$

注意事项

1、途径点气泡显示

/* 显示第几个中途点ETA和剩余电量，默认显示第一个，viaIndex 第几个途经点，如果等于-1，则显示全部途经点，包括服务器推荐的途径充电站，其中服务器推荐的充电站只支持全部显示*/

void com.autonavi.gbl.layer.BizGuideRouteControl.showViaETAByIndex(int viaIndex)

\u0000

","body_lake":null,"pub_level":null,"status":"0","updated_at":"2022-04-06 07:04:17","deleted_at":null,"nameSpace":"mnlcaa/v610","browseCount":216,"collectCount":0,"estimateDate":28,"docStatus":0,"permissions":true,"overView":false}}