Android导航SDK
    开发指南
    参考手册
    下载
  • 合规说明
    • Android导航SDK
    下载
    Android导航SDK

    Demo下载

    最后更新时间:2026-02-02


    Android导航SDK 7.5.0 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:7.5.0"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.8.0.07a0862"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:7.5.0"
}

    导航功能变更

    1. 步骑行导航方向标效果优化；
    2. 驾车导航途径点UI展示；
    3. 路况自定义样式支持动态修改；
    4. 新增驾车步行接驳信息；
    5. 偏航时支持点串还原；

    导航接口变更

    7.5.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.model NavWaypoint 新增/方法 int getTrafficLightNum(); 途径点红绿灯数量
    com.tencent.navix.api.map MapApi 新增/方法 void setTrafficStyle(TrafficStyle trafficStyle); 设置路况样式
    com.tencent.navix.api.model NavDriveRoute 新增/方法 NavDestinationWalkSceneTips getWalkSceneTips(); 目的地步行场景提示信息
    com.tencent.navix.api.model NavDestinationWalkSceneTips 新增/类 int getDistance();
    int getSceneType();
    String getPopupTitle();
    String getPopupContent();
    String getBubbleTitle();
    String getBubbleContent()    		 获取距离
    获取步行场景类型 0（无步行），1（室内步行），2（室外步行）
    获取弹窗标题
    获取弹窗内容
    获取气泡标题
    获取气泡内容
    com.tencent.navix.api.navigator NavigatorDrive 新增/方法 void setAutoHandleOffRoute(boolean autoHandleOffRoute); 设置自动处理偏航时点串还原，默认true
    如果设置为false，务必在{@link NavigatorDriveObserver#onOffRoute()}时手动调用{@link Navigator#reroute(com.tencent.navix.api.model.NavRerouteReqParam)}
    其中{@link NavRerouteReqParam}需要使用{@link NavRerouteReqParam#newBuilder(Class)}，Class为{@link com.tencent.navix.api.model.NavRerouteReqParam.OffRouteWithParamUpdateBuilder}
    或者
    com.tencent.navix.api.model NavRerouteReqParam.OffRouteWithParamUpdateBuilder 新增/类 OffRouteWithParamUpdateBuilder routePoints(List<NavGpsLocation> routePoints); 导航中重新算路参数-偏航带还原点串类型构造器
    com.tencent.navix.api.observer NavigatorDriveObserver 新增/方法 void onOffRoute(); 偏航回调

    Android导航SDK 7.4.0 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:7.4.0"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.8.0.07a0862"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:7.4.0"
}

    导航功能变更

    1. 路径规划支持设置订单ID；
    2. 支持导航截屏；
    3. 截屏功能配置优化；
    4. 支持北斗定位；
    5. 导航TTS支持设置音频焦点策略；

    导航接口变更

    7.4.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 void orderId(String orderId); 设置订单ID
    com.tencent.navix.api.layer NavigatorLayerRoot 新增/方法 void snapshot(SnapshotConfig snapshotConfig, SnapshotConfig.SnapshotCallback callback); 导航截屏
    com.tencent.navix.api.config SnapshotConfig 新增/方法 void setCompressQuality(int compressQuality);
    void setInterval(int interval);
    void setPixelQuality(PixelQuality pixelQuality);
    void setInterval(int interval);
    setOutputType(OutputType outputType);    		 设置截屏压缩质量[0-100]
    设置截屏间隔(ms)
    设置截屏像素质量
    设置截屏输出类型
    com.tencent.navix.api.config SnapshotConfig.PixelQuality 新增/类 LOW
    HIGH     		截屏像素质量
    com.tencent.navix.api.config SnapshotConfig.OutputType 新增/类 BYTE_ARRAY
    BITMAP    		 截屏输出类型
    com.tencent.navix.api.location LocationApi 新增/方法 setGnssSource(int source); 设置GNSS定位源：
    LocationApi#GNSS_SOURCE_GPS_FIRST(默认GPS优先)
    LocationApi#GNSS_SOURCE_BEIDOU_FIRST(北斗优先)
    com.tencent.navix.tts.api TTSPlayer 新增/方法 setAudioFocusPolicy(int policy); 设置音频焦点策略：
    TTSPlayer#AUDIO_FOCUS_POLICY_NONE(无音频焦点请求)
    TTSPlayer#AUDIO_FOCUS_POLICY_GAIN_TRANSIENT_MAY_DUCK(请求临时性音频焦点，允许其他应用降低音量播放)

    Android导航SDK 7.3.0 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:7.3.0"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.7.0.92a115a"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:7.3.0"
}

    导航功能变更

    1. 路径规划支持摩托车；
    2. 路径规划支持设置订单来源；
    3. 路径规划支持设置前序点类型；
    4. 路线解释性UI升级；
    5. 两轮车支持简要信息透出；
    6. 两轮车支持截屏；
    7. 定位优化；

    导航接口变更

    7.3.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 motorOptions(MotorOptions motorOptions); 设置摩托车路径规划参数
    com.tencent.navix.api.plan DriveRoutePlanOptions.MotorOptions 新增/类 详见javadoc 摩托车导航参数配置
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 orderSource(int source); 0: 未知; 1: 腾讯; 2: 滴滴; 3: 高德
    com.tencent.navix.api.model NavGpsLocation 新增/方法 setSourceType(int srcType); 3: gps;
    10: 网络点;
    12: gps推算点;
    0: 不可信点（默认）
    com.tencent.navix.api.observer NavigatorRideObserver 新增回调 onBriefInfoUpdate(String info); 两轮车导航简要信息更新。需两轮车权限
    com.tencent.navix.api.layer NavigatorLayerRootRide 新增/方法 snapshot(SnapshotConfig snapshotConfig, SnapshotConfig.SnapshotCallback callback); 两轮车导航截图。需两轮车权限
    com.tencent.navix.api.model SnapshotConfig 新增/类 详见javadoc 两轮车导航截屏配置及回调

    两轮车导航截图代码示例和注意事项：

    1. 截图会对底图和导航面板进行截图
    2. 底图NavigatorLayerRootRide类型必须使用TextureView类型
    // NavigatorLayerRootRide创建方式一：
<com.tencent.navix.api.layer.NavigatorViewStub
    android:id="@+id/navigation_view"
    android:layout_height="match_parent"
    android:layout_width="match_parent"
    android:layout_marginBottom="40dp"
    app:travel_mode="Riding"
    app:map_view_type="TextureView" />
// NavigatorLayerRootRide创建方式二：
NavigatorViewStub#setMapType(
    NavLayerRootAttributeSet.NavMapViewType.NAV_TEXTURE_VIEW)
// NavigatorLayerRootRide创建方式三：
NavigatorZygote.with(this).view(NavigatorLayerRootRide.class,
    NavLayerRootAttributeSet.newBuilder()
        .setMapViewType(NavLayerRootAttributeSet
            .NavMapViewType.NAV_TEXTURE_VIEW)
        .build());
    1. 截图导航面板SDK提供了一个简易面板NavigatorLayerViewRideCast，可以通过addViewLayer方法添加到NavigatorLayerRootRide上，开发者也可以自定义导航面板
    2. 截图参数设置：宽高（默认是256*256dp），回调间隔（1-10s，默认5s回调一次），格式（JEPG、PNG和WEBP，默认JPEG），质量（默认90，范围0-100，数字越大质量越高），截图角（RECTANGLE和ROUND，默认ROUND）
    3. 截图需使用单独的两轮车底图，添加到页面容器后隐藏，不影响到正常的导航底图页面
    private var config: SnapshotConfig? = SnapshotConfig.newBuilder().setWidth(800).setHeight(800).build()
// 注意：最好保证截图的宽高和底图的宽高一致，否则会图片会拉伸
findViewById<FrameLayout>(R.id.navigator_ride_container).apply {
    layoutParams = config?.let { 
	    FrameLayout.LayoutParams(it.width, it.height).apply { 
	        gravity = Gravity.CENTER 
	   } 
    }
    addView(navigatorLayerRootSnapshot as View)
    (navigatorLayerRootSnapshot as View).x = -3000f
}
// 用于截图的底图需要保证调用了onStart()和onResume()方法
NavigatorLayerRootRide#onStart
NavigatorLayerRootRide#onResume
NavigatorLayerRootRide.snapshot(config, callback)
// 截图完成时可以调用onPause()和onStop()方法
NavigatorLayerRootRide.snapshot(null, null)
NavigatorLayerRootRide#onPause
NavigatorLayerRootRide#onStop
// 页面退出时调用onDestroy()方法
NavigatorLayerRootRide#onDestroy
    1. 截图回调结果SnapshotConfig.SnapshotResult有下列几种情况：
    // 成功
SUCCESS(0, "success"),
// 导航简要信息数据版本不变
DATA_NOT_CHANGE(1, "data not change"), 
// 底图类型不是TextureView
MAP_VIEW_TYPE_INCOMPATIBLE(-1, "map view type incompatible"),
// 底图非resume状态
MAP_BACKGROUND(-2, "map must on resume"),
// 两轮车鉴权失败
AUTH_ERROR(-3, "no auth"),
// 底图截图失败
MAP_SNAPSHOT_ERROR(-4, "map snapshot error"),
// 内部错误
INTERNAL_ERROR(-5, "internal error");

    Android导航SDK 7.2.7 版本

    产物

    dependencies {
	// 导航核心库
	implementation "com.tencent.map:tencent-map-nav-sdk-core:7.2.7"
	// 基础依赖
	implementation "com.tencent.openmap:foundation:0.7.0.92a115a"
	// 导航内置TTS，可选
	implementation "com.tencent.map:tencent-map-nav-sdk-tts:7.3.0"
}

    导航功能变更

    1. 支持网约车场景驾车特定UI；
    2. 步骑行UI升级；
    3. 支持小车路径规划设置新能源类型；
    4. 支持开发者设置导航日志模块上报；
    5. 支持开发者设置红绿灯倒计时气泡是否展示；
    6. 支持开发者配置自动退出全览；
    7. 支持开发者传入点串还原导航；

    导航接口变更

    7.2.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.ui.api UIStyle 新增/类型 Classic
    Travel    		 驾车默认UI样式：经典UI、网约车UI
    com.tencent.navix.ui NavigatorLayerViewDrive 新增/方法 NavigatorLayerViewDrive(Context context, UIStyle style)
    NavigatorLayerViewDrive(Context context, AttributeSet attrs, UIStyle style)
    NavigatorLayerViewDrive(Context context, AttributeSet attrs, int defStyleAttr, UIStyle style)    		 根据UI样式初始化驾车默认UI
    com.tencent.navix.ui NavigatorLayerViewDriveClassic 新增/方法 NavigatorLayerViewDriveClassic(Context context)
    NavigatorLayerViewDriveClassic(Context context, AttributeSet attrs)
    NavigatorLayerViewDriveClassic(Context context, AttributeSet attrs, int defStyleAttr)    		 初始化驾车默认经典UI
    com.tencent.navix.ui NavigatorLayerViewDriveTravel 新增/方法 NavigatorLayerViewDriveTravel(Context context)
    NavigatorLayerViewDriveTravel(Context context, AttributeSet attrs)
    NavigatorLayerViewDriveTravel(Context context, AttributeSet attrs, int defStyleAttr)    		 初始化驾车默认网约车UI
    com.tencent.navix.ui.api.config ViewMarginConfig.Builder 新增/方法 setExtraMarginBottom(int extraMarginBottom) 设置面板额外的marginBottom
    com.tencent.navix.ui.api.config ViewMarginConfig 新增/方法 getExtraMarginBottom() 获取面板额外的marginBottom
    com.tencent.navix.api.plan DriveRoutePlanOptions.CarEnergyType 新增/类型 Unknown
    Diesel
    Hybrid
    Electric
    Gas    		 驾车能源类型：未知、柴油、油电混动、纯电、汽油
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 setEnergyType(CarEnergyType type) 设置驾车能源类型
    com.tencent.navix.api.plan DriveRoutePlanOptions 新增/方法 getEnergyType() 获取驾车能源类型
    com.tencent.navix.api.log RefluxOptions.Builder 新增/方法 setBeginTime(long beginTime) 设置日志回流开始时间
    com.tencent.navix.api.log RefluxOptions.Builder 新增/方法 setEndTime(long beginTime) 设置日志回流结束时间
    com.tencent.navix.api.log LogManagement 新增/方法 reflux(RefluxOptions options) 回流日志
    com.tencent.navix.api.config RouteElementConfig.BUilder 新增/方法 setTrafficLightCountDownEnable(boolean enable) 设置是否开启红绿灯倒计时
    com.tencent.navix.api.layer NavigatorLayerRoot 新增/方法 setNavOverlookConfig(NavOverlookConfig navOverlookConfig) 设置自动退出全览配置
    com.tencent.navix.api.layer NavigatorLayerRoot 新增/方法 getNavOverlookConfig() 获取自动退出全览配置
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 customRouteLocations(List<NavGpsLocation> customRouteLocations) 设置自定义路线点串
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 routeCoordsCutoff(boolean isRouteCoordsCutoff) 设置首次算路是否支持点串根据当前起点位置截断
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 rerouteCoordsCutoff(boolean isRerouteCoordsCutoff) 设置重算路是否支持点串根据当前起点位置截断

    网约车UI添加用户自定义信息区示例及注意事项：

    // 设置底部margin
val customHeight = DensityUtil.dpToPx(100f)
navigatorLayerView.setViewMarginConfig(ViewMarginConfig.builder().setExtraMarginBottom(customHeight).build())

// 初始化用户view，以TextView为例:
val customView = TextView(context)
// 注意：
// 1. 因为要实现退出确认页面以及设置页面盖在用户自定义信息区上面的效果，所以用户自定义信息区要添加到默认UI容器中，默认UI容器为ConstraintLayout，所以需要设置自定义用户信息区的约束条件
// 2. 必须设置vie的ID，否则会崩溃
// 3. 自定义信息区的高度 <= 设置的ViewMarginConfig.extraMarginBottom,否则自定义信息区会和默认UI组件有压盖
val layoutParams = ConstraintLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, customHeight)
layoutParams.bottomToBottom = ConstraintLayout.LayoutParams.PARENT_ID;
layoutParams.startToStart = ConstraintLayout.LayoutParams.PARENT_ID;
layoutParams.endToEnd = ConstraintLayout.LayoutParams.PARENT_ID;
customView.id = View.generateViewId()
customView.layoutParams = layoutParams
customView.text = "用户自定义信息区"
customView.textSize = 20f
customView.gravity = Gravity.CENTER
customView.setTextColor(Color.BLACK)
customView.setBackgroundColor(Color.GRAY)

// 将用户自定义信息区要添加到默认UI容器中，必须添加到navigatorLayerView.view中，否则添加无效
val layerView = navigatorLayerView.view
if (layerView is ViewGroup) {
  layerView.addView(customView)
}

    2025-05-27 Android导航SDK 7.1.0 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:7.1.0"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.5.5.2da11df-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:7.1.0"
}

    导航功能变更

    1.导航引擎全面升级，地图渲染效果、定位效果、导航效果全新优化。

    2.驾车导航默认UI全面改版，优化导航效果。

    3.支持使用外部 GPS 数据进行导航。

    导航接口变更

    7.1.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.config SimulatorConfig.Type 新增/类型 USE_EXTERNAL_LOCATIONS 使用外部点进行导航
    com.tencent.navix.api.simulate Simulator 新增/方法 updateExternalLocation(NavGpsLocation location) 更新外部定位点

    版本适配说明

    升级至 7.1.0 版本后，NavigatorLayerRootDrive 的相关方法需要在 NavigatorDrive 的 bindView() 方法执行后再调用才会生效。

    NavigatorDrive navigator = NavigatorZygote.with(getContext()).navigator(NavigatorDrive.class);
navigator.bindView(navigatorLayerRootDrive);
// 需要在调用 bindView() 之后再调用 NavigatorLayerRootDrive 的方法，否则会导致方法调用无效
navigatorLayerRootDrive.xxx();

    Android导航SDK 6.13.0 版本

    产物

    dependencies {
	// 导航核心库
	implementation "com.tencent.map:tencent-map-nav-sdk-core:6.13.0"
	// 基础依赖
	implementation "com.tencent.openmap:foundation:0.6.0.0454c7c"
	// 导航内置TTS，可选
	implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.13.0"
}

    导航功能变更

    1. 支持开发者设置红绿灯倒计时气泡是否展示；
    2. 支持开发者配置自动退出全览；
    3. 支持开发者设置是否打输出定位日志；
    4. 支持开发者设置推荐路线视图是否展示；
    5. 支持开发者传入点串还原导航。

    导航接口变更

    6.13.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.config RouteElementConfig.BUilder 新增/方法 setTrafficLightCountDownEnable(boolean enable) 设置是否开启红绿灯倒计时
    com.tencent.navix.api.layer NavigatorLayerRoot 新增/方法 setNavOverlookConfig(NavOverlookConfig navOverlookConfig) 设置自动退出全览配置
    com.tencent.navix.api.layer NavigatorLayerRoot 新增/方法 getNavOverlookConfig() 获取自动退出全览配置
    com.tencent.navix.api NavigatorConfig.LocationConfig.Builder 新增/方法 setOpenLog(boolean openLog) 设置是否打开定位日志
    com.tencent.navix.api NavigatorConfig.LocationConfig 新增/方法 isOpenLog() 获取是否打开定位日志
    com.tencent.navix.ui.api.config UIComponentConfig.UIComponent 新增/类型 ROUTE_RECOMMEND_VIEW 设置推荐路线视图显隐
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 customRouteLocations(List<NavGpsLocation> customRouteLocations) 设置自定义路线点串
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 routeCoordsCutoff(boolean isRouteCoordsCutoff) 设置首次算路是否支持点串根据当前起点位置截断
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 rerouteCoordsCutoff(boolean isRerouteCoordsCutoff) 设置重算路是否支持点串根据当前起点位置截断

    2025-02-13 Android导航SDK 6.12.1 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.12.1"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.5.5.2da11df-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.12.1"
}

    导航功能变更

    1. 导航路况刷新支持获取秒级ETA信息。
    2. 导航路况刷新时机优化。
    3. 修复剩余全览模式视野更新不及时问题。
    4. 定位优化。
    5. 稳定性优化。
    6. 已知问题修复。

    导航接口变更

    6.12.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.model NavDriveRouteData 新增/方法 getRemainingTimeInSeconds(...) 获取本次路况刷新后路线剩余预估时间，单位 秒

    2024-08-02 Android导航SDK 6.11.0 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.11.0"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.5.3.1eff80f-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.11.0"
}

    地图功能变更

    1. 同意隐私协议TencentMapInitializer#setAgreePrivacy拆分成两个方法，开发者使用地图功能前需先后调用TencentMapInitializer#setAgreePrivacy和TencentMapInitializer#start
    类 变动 方法&属性 说明
    TencentMapInitializer 新增接口 void start(Context context); 同意隐私协议之后启动地图功能
    1. 修复定位标精度圆加载慢问题
    2. 修复手绘图场景下地图加载完成不回调问题 4.初始化导航接口拆分。现在需要调用NavigatorZygote#init初始化导航，再调用NavigatorZygote#start开启导航之后，才可以使用后续接口。
    3. 修复Crash及Marker碰撞功能问题

    导航功能变更

    1. 初始化导航接口拆分。现在需要调用NavigatorZygote#init初始化导航，再调用NavigatorZygote#start开启导航之后，才可以使用后续接口。
    2. 初始路径规划参数支持设置距离最短。
    3. 放大图支持配置指定域名。
    4. 其他优化和已知问题修复。

    初始化和启动SDK示例

    // 设置同意地图隐私协议
TencentMapInitializer.setAgreePrivacy(applicationContext, true)
// 开启地图SDK
TencentMapInitializer.start(applicationContext)

// 初始化导航SDK
NavigatorZygote.with(applicationContext).init(NavigatorConfig.builder()
    .setUserAgreedPrivacy(true)  // 设置同意导航隐私协议
    .setDeviceModel(deviceModel)  // 设置型号，帮助问题排查
    .setDeviceId(loadGenerateId())   //设置唯一设备ID，帮助问题排查
    .build())
// 开启导航SDK
NavigatorZygote.with(applicationContext).start()

    导航接口变更

    6.11.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api NavigatorZygote 新增/方法 start(...) 开启导航SDK。需要在初始化之后，其他接口调用之前调用该方法
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 preferShortDistance(...) 设置驾车路线规划参数: 是否优先出距离短的路线, 默认为false

    2024-07-17 Android导航SDK 6.10.1 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.10.1"
	// 基础依赖
	implementation "com.tencent.openmap:foundation:0.5.2.85dd71e-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.10.1"
}

    导航功能变更

    1. 导航ETA刷新策略优化。
    2. 丰富路线解释性类型。
    3. 路线解释性透出限行区域ID。
    4. 导航地图支持自行设置建筑物3D。
    5. 支持高版本TargetApi。
    6. 定位功能优化。
    7. 已知问题修复。

    导航接口变更

    6.10.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.model NavRouteExplain 新增/方法 getDetailIDs(...) 获取限行区域ID，可能为null
    NavRouteExplain.Type 新增/属性 详见javadoc 新增路线解释性类型若干
    NavTTSInfo 新增/方法 getType(...) 导航TTS播报类型
    com.tencent.navix.api.loccation LocationApi 新增/方法 setEnableAntiMock(...) 设置是否开启定位作弊检测功能，默认为false
    LocationApi 新增/方法 setCellInfoGetInterval(...) 设置基站获取的时间间隔, 单位为 ms (毫秒)
    LocationApi 新增/方法 setFirstPoiUpdateExpirationTime(...) 设置首次定位等待逆地址解析的超时时间, 单位为 ms (毫秒)
    com.tencent.navix.api.map MapApi 新增/方法 setBuilding3dEffectEnable(...) 设置底图建筑物3D

    2024-06-15 Android导航SDK 6.9.2 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.9.2"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.5.0.e123272-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.9.2"
}

    导航功能变更

    1. 导航路径规划长距离支持分片。
    2. TTS播报支持设置播报速度。
    3. 包体积和内存优化。
    4. 鉴权错误上报和导航状态上报优化。
    5. 修复点击地图路线切换伴随时回调类型不一致的问题。
    6. 修复已知问题。

    导航接口变更

    6.9.0版本Javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 setRequestSlice(...) 设置算路分片类型。0：不分片；1：两段；2：三段。当分片类型为2时，需要NavigatorDriveObserver#onNavigationDataReady(…)回调成功后才能开启导航；如果回调失败，需要重试算路。
    com.tencent.navix.api.observer NavigatorDriveObserver 新增/方法 onNavigationDataReady(...) 导航数据ready，仅当驾车导航分片时有意义，若回调失败，需要重新算路才能发起导航
    com.tencent.navix.api.model NavNavigationStartFail 新增/属性 NavigationDataNotReady 新增开启导航回调失败类型，当三段分片算路未成功时
    com.tencent.navix.tts.api TTSPlayer 新增/方法 setDefaultSpeed(...) 设置默认播报速度
    新增/方法 play(String, int, int) 播放指定text，支持设置单条

    2024-03-01 Android导航SDK 6.7.10 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.7.10"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.3.2.692837d-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.7.10"
}

    导航功能变更

    1. 优化导航定位卡顿情况。
    2. 优化定位流量消耗。
    3. 优化低概率多次偏航的问题。
    4. 修复稳定性问题。
    5. 新增设置定位缓存大小。

    2024-01-26 Android导航SDK 6.7.7 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.7.7"
	// 基础依赖
	implementation "com.tencent.openmap:foundation:0.3.2.692837d-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.7.7"
}

    导航功能变更

    1. 新增配置算路结果缓存数量。
    2. 新增开启导航失败回调。
    3. 支持在非导航状态设置全览模式，视野将不做调整。

    导航接口变更

    • 设置导航算路缓存
    public interface NavigatorDrive extends Navigator {

    /**
     * 设置路径规划缓存数目，[1, 8]，默认为1，需要在首次路径规划前设置
     * @param routePlanCacheSize
     */
    void setRoutePlanCacheSize(int routePlanCacheSize);
}
    • 开启导航失败回调
    public interface BaseNavigatorObserver {

    /**
     * 开始导航失败回调
     * @param routeId
     * @param fail
     */
    void onDidStartNavigationFail(String routeId, NavNavigationStartFail fail);

}

    2024-01-05 Android导航SDK 6.7.5 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.7.5"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.3.1.a45d56b-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.7.5"
}

    导航功能变更

    1. 提升稳定性。

    2023-12-18 Android导航SDK 6.7.3 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.7.3"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.2.1b552a4-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.7.3"
}

    导航功能变更

    1. 支持导航过程中动态切换车道线的展示和隐藏

    2023-12-06 Android导航SDK 6.7.1 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.7.1"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.2.1b552a4-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.7.1"
}

    导航功能变更

    1. 修复已知问题

    2023-11-14 Android导航SDK 6.7.0 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.7.0"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.2.1b552a4-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.7.0"
}

    导航功能变更

    1. 支持配置终点到达参数。
    2. 定位接口首次回调定位将在添加定位回调1S以后。
    3. 导航播报文案标点符号优化。
    4. 已知问题修复。

    导航接口变更

    Ref: javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.navigator NavigatorDrive 新增/方法 setDestArriveConfig(...) 设置终点到达策略
    com.tencent.navix.api.config DestArriveConfig 新增/类 详见javadoc 终点到达策略配置

    2023-10-24 Android导航SDK 6.6.0 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.6.0"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.2.1b552a4-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.6.0"
}

    变更

    导航功能变更

    1. 货车路径规划请求支持设置是否需要经验路线。
    2. 货车路径规划返回经验路线ID。

    导航接口变更

    Ref: javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.plan DriveRoutePlanOptions.TruckOptions.Builder 新增/方法 setNeedExperienceRoute(...) 是否使用经验路线
    com.tencent.navix.api.model NavDriveRoute 新增/方法 getExperienceRouteId(...) 获取经验路线ID，当经验路线生效时有意义

    2023-09-28 Android导航SDK 6.5.3 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.5.3"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.2.1b552a4-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.5.3"
}

    变更

    1. 修复已知问题

    2023-09-22 Android导航SDK 6.5.2 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.5.2"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.2.1b552a4-lite"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.5.2"
}

    变更

    1. MapApi新增接口(setInfoWindowAdapter/addVectorOverlay/setPointToCenter)
    2. 优化定位，降低导航卡顿率
    3. 定位服务地址配置支持从assets中读取
    4. 优化步骑行导航

    2023-09-13 Android导航SDK 6.5.1 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.5.1"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.2.1b552a4"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.5.1"
}

    变更

    1. 导航路径规划新增独立算路功能。
    2. TTS新增播放状态回调。
    3. 模拟导航支持始终沿着当前主路线行驶。
    4. 导航路径规划支持自动传入前序点。
    5. 步骑行导航优化。
    6. 路线限行信息。
    7. 货车算路鉴权。

    导航接口变更

    Ref: javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.plan DriveRoutePlanService 新增/类 详见javadoc 独立路径规划
    com.tencent.navix.api.model NavDriveRoute 新增/方法 getLimitStatus(...) 获取限行区域信息
    com.tencent.navix.api.tts TTSPlayer 新增/方法 addTTSPlayListener(...) 添加TTS播放回调
    新增/方法 removeTTSPlayListener(...) 移除TTS播放回调
    TTSPlayListener 新增/类 详见javadoc TTS播放回调
    com.tencent.navix.api.config SimulatorConfig.Type 新增/属性 SIMULATE_LOCATIONS_ALWAYS_ALONG_MAIN_ROUTE 总是沿着当前主路线模拟

    2023-09-11 Android导航SDK 6.4.3 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.4.3"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.2.1b552a4"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.4.3"
}

    变更

    1. 修复稳定性问题。
    2. 到达目的地后再向前行驶50米后再触发偏航

    2023-09-01 Android导航SDK 6.3.7 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.3.7"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.2.1b552a4"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.3.7"
}

    变更

    1. 修复稳定性问题。

    2023-08-23 Android导航SDK 6.4.1 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.4.1"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.1.977ebd3"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.4.1"
}

    变更

    1. 新增检索域名替换接口
    2. 优化并行执行线程池
    3. 修复CameraChange响应两次回调问题
    4. 修复其他偶现稳定性问题

    2023-08-17 Android导航SDK 6.3.6 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.3.6"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.0.d5715b8"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.3.6"
}

    变更

    1. 修复线、面覆盖物在一些场景下发生交互、渲染不一致问题
    2. 修复地图多实例下偶现的崩溃异常
    3. 修复地图多实例下偶现MapLoaded事件不回调问题
    4. 修复可视化功能不生效问题
    5. 修复稳定性问题。

    2023-08-07 Android导航SDK 6.4.0 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.4.0"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.0.d5715b8"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.4.0"
}

    导航功能变更

    1. 定位接口增加地理围栏功能。
    2. 自定义路线标签及未生效原因。
    3. 其他已知问题修复。

    导航接口变更

    Ref: javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.location LocationApi 新增/方法 addFence(...) 添加一个围栏
    新增/方法 removeFence(...) 移除一个围栏
    com.tencent.navix.api.model NavDriveRoutePlan 新增/方法 getCustomRouteReason() 自定义路线原因，仅在自定义路线未生效时有值
    NavDriveRoute 新增/方法 getCustomTags() 自定义标签flag
    NavDriveCustomRouteReason 新增/类 详见javadoc 路线被过滤原因
    NavRouteFilterLink 新增/类 详见javadoc 被过滤的路线Link信息

    2023-08-07 Android导航SDK 6.3.5 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.3.5"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.2.0.d5715b8"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.3.5"
}

    变更

    1. 修复稳定性问题。
    2. 修复低版本兼容性问题。

    2023-07-26 Android导航SDK 6.3.3 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.3.3"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.1.7.a5ad3da"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.3.3"
}

    变更

    1. 修复地图Overlay概率无法移除的问题。
    2. 修复导航中修改目的地Marker可能不符合预期的问题。
    3. 修复延迟绑定视图时部分配置不生效的问题。
    4. so库新增armeabi架构。
    5. 稳定性问题修复。

    2023-07-14 Android导航SDK 6.3.2版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.3.2"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.1.7.a5ad3da"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.3.2"
}

    地图功能变更

    1. 修复地图稳定性问题。

    2023-07-05 Android导航SDK 6.3.1 版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.3.1"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.1.7.d8cf12b"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.3.1"
}

    Demo: TencentNaviDemo_Android_6.3.1.zip

    导航功能变更

    1. 交规信息新增路名。
    2. 导航中前方违反交规信息回调转移至NavDriveDataInfo。
    3. 其他已知问题修复。

    导航接口变更

    Ref: javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.model NavDriveDataInfo 新增/方法 getRestrictionInfo(...) 前方违反交规信息
    NavTruckRestriction 新增/方法 getRoadName(...) 当前路名
    NavTurnRestriction 新增/方法 getRoadName(...) 当前路名
    com.tencent.navix.api.observer NavigatorDriveObserver 删除/方法 onRestrictionInfoUpdate(...) 前方限行信息更新。 现在回调数据合并至NavigatorDriveObserver#onNavDataInfoUpdate(...)

    地图功能变更

    1. suggestion接口不强制校验Region。
    2. 逆地址解析接口新增standard_address字段、控制返回street_number是否拼接路名，接口为Geo2AddressParam.streetNumberFormat(StreetNumberFormat format)。
    3. 修复线和Marker的点击覆盖问题。
    4. 修复稳定性问题。

    2023-05-31 Android导航SDK 6.3.0版本

    产物

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.3.0"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.1.7.a5ad3da"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.3.0"
}

    导航功能变更

    1. 路径规划结果路线新增收费路段里程。
    2. 导航中新增前方违反交规信息。
    3. 导航中新增智能定位能力。
    4. 默认UI放大图可配置圆角弧度。
    5. 其他已知问题修复。

    导航接口变更

    Ref: javadoc

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.observer NavigatorDriveObserver 新增/方法 onRestrictionInfoUpdate(...) 前方限行信息更新
    com.tencent.navix.api.model NavDriveRoute 新增/方法 getTollDistance(...) 收费路段长度，单位米
    新增/方法 getTruckRestrictions(...) 违反交规的货车限制信息
    新增/方法 getTurnRestrictions(...) 违反交规的转向限制信息
    NavRestrictionInfo 新增/类 详见javadoc 导航中前方限制信息
    NavTruckRestriction 新增/类 详见javadoc 货车限制信息
    NavTruckRestrictionType 新增/类 详见javadoc 货车限制类型
    NavTruckRestrictionInfo 新增/类 详见javadoc 导航中货车限制信息
    NavTurnRestriction 新增/类 详见javadoc 转向限制信息
    NavTurnRestrictionType 新增/类 详见javadoc 转向限行类型
    NavTurnRestrictionInfo 新增/类 详见javadoc 导航中转向限制信息
    com.tencent.navix.ui.api.config EnlargedMapUIConfig.Builder 新增/方法 setRoundCorners(...) 设置放大图圆角

    地图功能变更

    1. 定位标精度圈默认隐藏
    2. 货车路线规划新增toll_distance、traffic_light_count、restriction、searchByCityList字段
    3. 路线点击回调bugfix
    4. 线扩大范围判定接口GeometeryUtil.isPolylineHitTest
    5. 实线多边形帧率优化

    2023-05-15 Android导航SDK 6.2.0版本

    产物

    依赖：

    dependencies {
    // 导航核心库
    implementation "com.tencent.map:tencent-map-nav-sdk-core:6.2.0.20230515205609-SNAPSHOT"
    // 基础依赖
    implementation "com.tencent.openmap:foundation:0.1.6.f419064"
    // 导航内置TTS，可选
    implementation "com.tencent.map:tencent-map-nav-sdk-tts:6.2.0.20230515205609-SNAPSHOT"
}

    javadoc：https://mapapi.qq.com/sdk/navi/Android/docs/6_2_0/index.html demo：https://mapapi.qq.com/sdk/navi/TencentNavigation_Android_6.2.0_SNAPSHOT_0515.zip

    功能

    1. 导航地图新增API接口
    2. 导航默认UI新增放大图回调
    3. 算路参数新增忽略车重、是否规避限行
    4. 算路Segment新增所属城市adcode
    5. 算路SegmentRoadName新增道路等级、属性及长度
    6. 导航中新增获取已驶过距离、已行驶时间信息
    7. 导航中回调前方电子眼信息
    8. 导航中红绿灯倒计时功能
    9. 导航中路线新增剩余红绿灯数量
    10. 导航中路线变更回调新增路线刷新类型
    11. 默认UI新增路况光柱图对外能力，提供自定义接口

    接口变更

    包名 类/接口 类型 方法/属性 说明
    com.tencent.navix.api.plan DriveRoutePlanOptions.Builder 新增/方法 avoidLimit(...) 路径规划是否规避限行
    DriveRoutePlanOptions.TruckOptions.Builder 新增/方法 setIgnoreWeight(...) 货车路径规划是否忽略车重
    com.tencent.navix.api.observer NavigatorDriveObserver 新增/方法 onCameraInfoUpdate(...) 前方电子眼信息更新回调
    com.tencent.navix.api.model NavCameraInfo 新增/类 详见javadoc 电子眼信息
    NavMainRouteChangeReason 新增/类 详见javadoc 主路线变更原因
    NavDriveDataInfo 新增/方法 getPassedDistance(...) 获取本次导航已走过距离
    新增/方法 getPassedTime(...) 获取本次导航已走过时间
    NavDriveRouteData 新增/方法 getRemainingTrafficLightCount(...) 获取路线上剩余红绿灯数量
    NavRouteSegment 新增/方法 getAdCode(...) 获取Segment所属adcode
    NavRouteSegmentRoadName 新增/方法 getLength(...) 获取SegmentRoadName长度
    新增/方法 getGrade(...) 获取SegmentRoadName等级
    新增/方法 getKind(...) 获取SegmentRoadName属性
    com.tencent.navix.ui.api NavigatorLayerViewDriveApi 新增/方法 getUIComponent(...) 获取特定默认面板指定View
    新增/方法 addViewCallback(...) 向导航面板添加视图回调
    新增/方法 removeViewCallback(...) 向导航面板移除视图回调
    NavigatorLayerViewDriveApi.ViewCallback 新增/方法 onEnlargedMapUIShow(...) 导航面板展示放大图回调，给出放大图位置信息
    新增/方法 onEnlargedMapUIHide(...) 导航面板隐藏放大图回调
    com.tencent.navix.ui.component NavTrafficBar 新增/类 详见javadoc 提供对外的路况光柱图能力
    com.tencent.navix.api.map MapApi 新增/方法 addTencentMapGestureListener(...) 向地图添加手势回调
    新增/方法 removeTencentMapGestureListener(...) 向地图移除手势回调
    新增/方法 getCameraPosition(...) 获取地图相机位置
    新增/方法 getMapContext(...) 获取地图MapContext
    新增/方法 getUiSettings(...) 获取地图UiSettings

    Android地图SDK 5.1.0版本

    功能

    1. Marker调整到最上层: Marker.setOnTop();
    2. 获取屏幕内全部marker: TencentMap.getScreenMarkers();
    3. 新增距离矩阵接口: TencentSearch.getDistanceMatrix(MatrixParam param, HttpResponseListener listener); （货车距离矩阵计算构造参数使用TruckingMatrixParam)
    4. 货车路线规划新增接口字段: TruckingParam.setTruckLoad、setTrailerType、setGoodsType、setEnergyType、setGasEmissionStandard、setPassType
    5. 驾车/货车路线规划返回结果Route新增字段: toll_distance、routeSearchCityList
    6. 地点检索SearchParam新增接口字段: SearchParam.subTitleFormat、getCategoryCode
    7. 地点检索返回结果新增POI分类码字段: category_code
    8. 圆形的虚线描边: 配置描边疏密: CircleOptions.pattern(List pattern); 配置描边类型: CircleOptions.borderType(CircleBorderType borderType);
    本页内容