android开发导航sdk Android导航SDK开发指南（26页）-原创力文档

Android 导航SDK 开发指南

一、概述

Android 导航SDK 目前为V1.1 版本，以.jar 形式提供，请广大开发者使用SDK 前务必

在官网申请key，以便全部功能顺利使用。

Android 导航 SDK 是一款针对在线导航的产品，产品功能包括规划路线、模拟导航、

获取导航播报信息、路况信息、路口放大图等信息。此外，该产品的导航路径支持驾车、步

行导航，同时可添加最多16 个途经点，包含6 种不同的导航策略，更有实时路况播报等功

能，力求为用户提供更加合理、准确的导航服务。

二、配置工程

2.1 Eclipse 配置工程

开发工程中新建“ libs ”文件夹，将CMCC_Android_Navi_SDK_V2.10.3jar 包

拷贝到 libs 的根目录下。拷贝完成后的工程目录，如图所示：

2.2 Android Studio 配置工程

1、为项目添加导航SDK

将cmmap_navi.jar 包复制到libs 目录下，如图所示：

2.3 代码混淆

在生成apk 进行代码混淆时进行如下配置(如果爆出warning ，在报出warning 的包加入类似

的语句：-dontwarn 包名)

2.4 添加用户 Key 和appID

在工程的“ AndroidManifest.xml ”文件如下代码中添加您的用户 Key 和appID

2.5 添加权限

在工程的“ AndroidManifest.xml ”文件中进行添加，请直接拷贝。

//导航需要的基础权限

三、导航SDK 初始化

注意：规划路线功能需要联网使用，由此产生的流量费用由运营商收取。

MapNavi 为导航类，提供计算导航路径的相关方法，在进行规划路线之前，需要初始化导航

引擎。

3.1 获取导航实例对象

示例代码如下：

MapNavi 对象是单实例的，导航过程(规划路线、实时导航)未结束时，请不要销毁MapNavi

对象，以免影响正常使用。

3.2 添加导航事件监听

示例代码如下

3.3 实例化导航事件监听对象

示例代码如下

/**

* 导航监听回调事件，主要用于监听路线计算结果

*/

private MapNaviListener mMapNaviListener = new MapNaviListener() {

@Override

public void onStartNavi(int type) {

android.util.Log.i(TAG, "onStartNavi:" + Util.formatNaviType (type));

}

@Override

public void onInitNaviSuccess() {

android.util.Log.i(TAG, "onInitNaviSuc