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