Android导航SDK 5.X

开发指南

参考手册

下载

资源下载

TencentNaviSDK_Android_Demo_v5.4.6.0

2023-07-05 TencentNaviSDK_Android_v5.4.6.0

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.14.5'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.4.6.0'
}

更新日志

导航过程中新增已行驶里程和用时。
- NavigationData#getHasPassedDistance(…) 已走过里程 / NavigationData#getHasPassedTime(…) 已用时
更新定位SDK，优化智能定位效果。
途经点剩余距离优化。
修复已知问题。

2023-06-07 TencentNaviSDK_Android_v5.4.5.0

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.14.3'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.4.5.0'
}

更新日志

增加地理围栏功能（圆形、多边形）。
- IFusionGeoLocationAdapter#addFence(…)增加一个地理围栏；IFusionGeoLocationAdapter#removeFence(…)移除一个地理围栏。
增加TTS播报真实开始和结束的回调
- TtsHelper#addTtsPlayListener(…)增加一个TTS播放监听；TtsHelper#removeTtsPlayListener(…)移除一个TTS播放监听。
新增内置的默认的TTS音频焦点策略。
新增智能定位。

2023-04-17 TencentNaviSDK_Android_v5.4.4.1

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.13'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.4.4.1'
}

更新日志

增加行中ETC回调。
- TencentNaviCallback新增回调onTollStationInfoUpdate。导航过程中通常在驶出收费站时回调。
增加内部道路路线解释性信息。

2022-12-13 TencentNaviSDK_Android_v5.4.2.3

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.10'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.4.2.3'
}

更新日志

提供单条伴随路线显示与隐藏的能力。

新增方法 CarNaviView#showBackupRoute(…)、 CarNaviView#hideBackupRoute(…) 控制单条备选路线的展示和隐藏

路线规划规避疫情区域

新增方法CarRouteSearchOptions#setAvoidCovidArea(…)设置路径规划是否规避疫情区域，默认为false

提供实时路线数据时增加路况的数据 RouteData#getTrafficItems(…)
导航上报开启、结束等状态
自车标导航引导线使用引擎接口
修复低概率的定位流量异常
修复已知问题

2022-08-12 TencentNaviSDK_Android_v5.4.1.3

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.6.2'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.4.1.3'
}

更新日志

新增获取当前路线的方法

新增方法 TencentCarNaviManger#getCurrentRoute() 获取当前道路初始算路时的数据

语音播报提供空闲时段回调

新增回调 TencentNaviCallback#onEnterIdleSection(IdleRangeInfo idleRangeInfo) 通知TTS空闲段落

起终点策略字段新增场站吸附定义

新增属性 NaviPoi#NAVI_POI_SEARCH_TYPE_STATION定义，用于路径规划为终点的场站吸附策略

NavigationData补充机动点的转向类型

新增方法 NavigationData#getTurnDirection()

路径规划新增是否为新能源车的字段

新增字段 CarRouteSearchOptions#isGreenCar 标识是否为新能源车，默认false

骑行算路结果增加路口数

新增方法 RouteData#getCrossNumber() 获取骑行算路结果路口数。仅骑行算路时有意义

补充伴随的路线信息中包含推荐理由

新增方法 RouteData#getRecommendType() 获取路线推荐理由，-1为默认，0-更快，1-封路，2-限行。仅补充伴随时有意义

导航路线中增加点事件
诱导引擎的到达目的地后偏航逻辑增强
导航默认视图显示/隐藏电子眼/罗盘接口针对全局生效

2022-10-09 TencentNaviSDK_Android_v5.4.0.4

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.6.2'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.4.0.8'
}

更新日志

大定位支持拼车场景的判偏逻辑。

新增接口 TencentCarNaviManager#setWaypointRemovedStrategy(WaypointRemovedStrategy) 用于设置途径点的移除策略: WaypointRemovedStrategy.Default默认策略为自动移除；WaypointRemovedStrategy.Manually为手动移除

默认为自动移除；如果设置为WaypointRemovedStrategy.Manually；导航将不会为你自动判达途径点，需要手动调用TencentCarNaviManager#changeWayPoints(List wayPoints)等相关方法手动移除

支持动态换路能力。

新增回调 INaviView#onRouteRecommend(RecommendRouteInfo recommendRouteInfo) 导航过程中，当出现推荐路线时，该方法会被回调，具体路线信息可参考类RecommendRouteInfo
新增回调 INaviView#onRouteDidChange(RouteData route, ArrayList trafficItems, RouteChangedReason reason) 相比于INaviView#onRouteDidChange(RouteData route, ArrayList trafficItems)，新回调会额外给出改变路线的原因，比如静默换路，其他原因可参考RouteChangedReason

在收到推荐路线回后，你可以根据情况调用原有接口TencentCarNaviManager#changeToFollowedRoute(String routeID)选择改变路线

自动比例尺功能自适应放大图。
自车点方向角矢量化。
开始导航时不再展示初始路径规划的伴随路线，并新增伴随路线展示率统计。
其他已知问题修复

2022-07-07 TencentNaviSDK_Android_v5.3.9.3

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.6'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.9.3'
}

更新日志

增加【用户已同意隐私协议】确认接口，如果未设置为同意，则无法进行导航。新增方法TencentNavi#setUserAgreePrivacy(…)

    // 需要注意的是，TencentNavi.setUserAgreePrivacy(true)需要在初始化前设置，并且确保导航相关接口调用前已调用地图隐私相关接口
    // 以下是一种正确的初始化顺序
    TencentMapInitializer.setAgreePrivacy(true);
    TencentNavi.setUserAgreePrivacy(true);
    TencentNavi.Config config = new TencentNavi.Config();
    config.setDeviceId("xxx");
    TencentNavi.init(getApplicationContext(), config);

敲击诱导面板增加轮次播报回放。新增方法TencentCarNaviManager#requestTts(…)
路线规划结果增加是否命中终点延伸吸附策略字段。新增方法CalcRouteResult#isHitEndAdsorbExtStrategy(…)
提升途经点实时剩余时间准确性。
默认导航诱导看板增加附属诱导看版。
增加播报模式选择方法，提供标准模式、简洁播报、静音模式，默认为标准模式。新增方法TencentCarNaviManager#setCarNavTtsMode(…)
优化放大图复现逻辑。当拖动地图时进入回弹模式并且正在展示的放大图会消失，回到3D导航模式时放大图复现。放大图回调INaviView#onShowEnlargedIntersection(…)和INaviView#onHideEnlargedIntersection()在本版本被彻底废弃，放大图相关回调请使用TencentNaviEnlargedIntersectionCallback#onShowEnlargedIntersection()和TencentNaviEnlargedIntersectionCallback#onHideEnlargedIntersection()
丰富路线解释性类型。具体查看RouteExplain新增变量。
优化起点吸附准确性。

2022-04-07 TencentNaviSDK_Android_v5.3.8.3

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.5.1-lite'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.8.3'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.1.0.1'
}

更新日志

优化导航过程中的稳定性
修复已知问题
优化设备信息获取策略

2022-03-23 TencentNaviSDK_Android_v5.3.8.1

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.4-lite'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.8.1'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.9'
}

更新日志

长直行展示对应icon;
丰富电子眼属性(鸣笛、不系安全带、打电话) ;
已走过路口的红绿灯icon不再展示;
Tips大图分类型预加载和展示 ;
语音播报支持顺序播报;
途经点比例尺自适应策略优化;
全览模式下，导航路线及伴随路线均在屏幕中展现 ;
内部道路渲染为蓝色;
路线解释性透出限行信息。

2022-03-09 TencentNaviSDK_Android_v5.3.7.5

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.3'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.7.5'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.9'
}

更新日志

优化途径点相关的判达与偏航逻辑；
优化放大图出图策略；
优化定位回调的adcode获取速度。

2022-02-24 TencentNaviSDK_Android_v5.3.7.2

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.3'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.7.2'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

解决偶发定位模块操作数据库引起的ANR问题。
RouteSegment对外透出direction字段。

2022-02-18 TencentNaviSDK_Android_v5.3.7.1

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.5.3'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.7.1'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

更新导航页的默认UI；
Tips路口大图功能，增加大图出图率。
更新诱导引擎，提升诱导体验；
优化途径点判达逻辑；
更新拥堵气泡样式，等灯样式；
出放大图时拖动地图，放大图消失并给出消失回调。

2022-01-23 TencentNaviSDK_Android_v5.3.6.1

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.6.1'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

修复启停播报不生效的问题；
优化切全览模式时红绿灯展示/隐藏时机；
修复获取伴随路线的分歧点信息为空的问题；
修复初始路径规划接口的乘客指路字段isSearchByRouteIDWorking错误的问题。

2022-01-12 TencentNaviSDK_Android_v5.3.6.0

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.6.0'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

更新导航页的默认UI；
CarNaviView新增setCarRouteConfig(CarRouteConfig)方法，可动态调整当前路线/伴随路线的样式；
CarNaviView 弃用setNaviLineColor(HashMap) 和 setNaviFollowLineColor(HashMap) 方法，请改为使用 setCarRouteConfig(CarRouteConfig)；
优化默认面板的高速出口样式；
默认面板，距离转向路口0米时修改为"现在";
新增电子眼样式：礼让行人、压线。

2022-01-12 TencentNaviSDK_Android_v5.3.5.2

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.5.2'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

解决使用默认顶部导航面板偶现crash问题;
修复放大图偶现不展示的问题.

2021-12-29 TencentNaviSDK_Android_v5.3.5.1

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.5.1'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

新增初始路径规划与偏航重算的成功失败回调，增强扩展性;

// 算路接口新增回调：
CalcRouteCallback#onCalcRouteSuccess(CalcRouteResult);
CalcRouteCallback#onCalcRouteFailure(CalcRouteResult);

// 偏航成功和失败新增接口：
TencentNaviCallback#onRecalculateSuccess(CalcRouteResult result);
TencentNaviCallback#onRecalculateFailure(CalcRouteResult result);

// 新增错误码：
public static final int ERR_CODE_CHANGE_ROUTE_BY_ID_FAILED = 2008;
public static final String ERR_MSG_CHANGE_ROUTE_BY_ID_FAILED = "乘客选路失败";

// 新增偏航类型：
public static final int REASON_SEARCH_BY_ROUTE_ID = 8; // 乘客选路导致的重算

乘客指路返回成功失败标识。CalcRouteResult新增isSearchByRouteIDWorking字段；
导航过程中可以进行乘客指路。对应方法:TencentCarNaviManager#changeRouteByRouteId(String routeID);
NavigationData给出超速提醒字段: isSpeedingReminder;
默认车速表支持根据车信长度自动调整位置；
优化2D导航下路线擦除效果；
扩展车信类型；
升级诱导播报版本，优化导航体验。

2022-02-18 TencentNaviSDK_Android_v5.3.4.7

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.4.7'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

更新TTS播报模块

2022-01-12 TencentNaviSDK_Android_v5.3.4.6

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.4.6'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

解决使用默认顶部导航面板偶现crash问题。

2022-01-09 TencentNaviSDK_Android_v5.3.4.5

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.4.5'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

修复放大图偶现不展示的问题；
修改拥堵气泡时间显示不正确的问题；
优化导航SDK对定位能力的封装逻辑；

2021-12-31 TencentNaviSDK_Android_v5.3.4.4

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.4.4'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

解决放大图失败重试异常情况导致的请求次数过高的问题;
修复RouteData#getDistanceInfo()为空的问题；

2021-12-22 TencentNaviSDK_Android_v5.3.4.3

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.4.3'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

修复途径点marker展示层级错误的问题；
修复偶现路径规划请求延迟问题。

2021-12-01 TencentNaviSDK_Android_v5.3.4

//module 依赖
dependencies {
    // 地图库
    implementation 'com.tencent.map:tencent-map-vector-sdk:4.4.5.8'
    // 导航库
    implementation 'com.tencent.map:tencent-map-nav-sdk:5.3.4.0'
    // 导航依赖库
    implementation 'com.tencent.map:tencent-map-nav-surport:1.0.2.8'
}

更新日志

重构导航服务数据序列化反序列化模块，解决部分车机设备路径规划服务耗时过长的问题;
导航SDK解决合规问题;
优化电子眼展示，支持最多3排展示;
优化放大图预下载机制;
优化伴随气泡展示位置;
更新导航路线上的红绿灯图片资源，展示效果更佳;
调整CarNaviView默认的最小比例尺，从14调整为15;
升级导航引擎，提升导航体验。

试试AI总结

不想看文档？直接问AI～

这篇文档对您是否有帮助？

有帮助

没帮助